> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Raw Data API
[Back to API List](/ai-for-service/apis/quality-ai/api-list)
Provides programmatic access to interaction-level Quality AI and Conversation Intelligence data via API. It returns evaluation metrics, sentiment, emotions, duration status, Generated and Configured Intents (L1–L3 hierarchy, confidence, sentiment, resolution), custom fields, and voice-specific metrics.
By default, contacts with a duration below the configured minimum are excluded; the `include_below_threshold=true` parameter enables inclusion. New fields—`contact_direction`, audit workflow details, and recording links—enable direction-based reporting, audit tracking, and advanced analytics, while preserving full raw interaction context.
| **METHOD** | **POST** |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Endpoint | `https://{{host}}/qualityai/api/v1/public/qualitymanagement/app/{{streamId}}/rawdata` |
| Content Type | `application/json` |
| Authorization | `auth: {{JWT}}` — See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction#generating-the-jwt-token). |
| API Scope | Quality Management Analytics. |
## Header Parameters
| Parameter | Description | Type |
| -------------- | ------------------------------------------------------------------ | ---------------- |
| `Content-Type` | `application/json` | string, required |
| `accountId` | Unique account identifier. For example, `67a9ca06cf0e510a8632xxxx` | string, required |
| `orgId` | Unique identifier of the organization. | string, required |
| `auth` | JWT token used for authentication. | string, required |
## Path Parameters
| Parameter | Description | Type |
| ---------- | ---------------------------------------------------------------- | ---------------- |
| `host` | Environment URL. For example, `https://platform.kore.ai/` | string, required |
| `streamId` | `botId` or `streamId`. Retrieve this from the App Settings page. | string, required |
## Sample Request
```bash theme={null}
curl --location 'https://{{host}}/qualityai/api/v1/public/qualitymanagement/app/{{streamId}}/rawdata' \
--header 'accountId: {{accountId}}' \
--header 'auth: {{JWT_TOKEN}}' \
--header 'Content-Type: application/json' \
--header 'orgId: o-da5be4e0-8fbb-5229-ac20-9b1384ebxxxx' \
--data '{
"offset": 0,
"startDate": "2026-03-23 10:17:54",
"endDate": "2026-03-23 23:00:35",
"limit": 5,
"page": 1
"contact_direction": "inbound"
}'
```
## Body Parameters
| Parameter | Description | Type |
| ------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------- |
| `offset` | Number of records to skip for pagination. | integer, required |
| `startDate` | The start date to include records. Use UTC format: `YYYY-MM-DDTHH24:MM:SS`. For example, `2026-03-23 10:17:54`. | string, required |
| `endDate` | The end date to include records. Use UTC format: `YYYY-MM-DDTHH24:MM:SS`. For example, `2026-03-23 23:00:35`. | string, required |
| `limit` | The number of conversation records to return. The default is `10`. | integer, optional |
| `page` | The page number for pagination. The default value is `1`. | integer, optional |
| `include_below_threshold` | Includes `below-threshold` contacts. | boolean (optional) |
| `custom_fields` | Business-specific metadata filters. | `object` (optional) |
| `contact_direction` | Resolved direction: `inbound` or `outbound`. | string (optional) |
APIs exclude contacts below the threshold by default. An `include_below_threshold=true` parameter allows explicit inclusion for ad hoc analysis.
## Sample Response
```json theme={null}
{
"results": [
{
"conversationId": "c-0bba1c4-6d27-49d9-8557-9b0e8774xxxx",
"contact_direction": "inbound",
"is_direction_defaulted": false,
"AuditStatus": "Audited",
"AuditScore": 77,
"audit_date": "2026-03-23 12:30:00",
"auditor": "John Doe",
"Queues": [
{
"Queue ID": "qu-c304439-3d79-4389-b1cb-014eb75axxxx",
"Queue Name": "Default Queue - Q1"
}
],
"Agents": [
{
"Agent ID": "a-424ea65-322b-47c1-8189-7200b64cxxxx",
"Agent Name": "John Doe"
},
{
"Agent ID": "a-a25ad66-638d-46c0-b4db-7e5a7360xxxx",
"Agent Name": "John Doe"
}
],
"koreEvalutionScore": 77,
"fatalErrorCount": 0,
"Language": "English",
"duration_status": "evaluated",
"Metrics": [
{
"Metric ID": "em-44758b38-816c-557b-b6a9-2d2c6297xxxx",
"Metric Name": "UK Greeting Compliance Rate GEN",
"Metric Weight": 28,
"Metric Negative Weight": 27,
"Qualification": "YES",
"isFatalError": false
},
{
"Metric ID": "em-1fd43c3f-67f9-5c30-8140-c3e534a1xxxx",
"Metric Name": "Manual Evaluation - UK - Manual Evaluation Metric",
"Metric Weight": 0,
"Metric Negative Weight": 0,
"Qualification": "-",
"isFatalError": false
}
]
},
{
"conversationId": "c-8d43539-ae1e-473a-ad97-6bd2add4xxxx",
"contact_direction": "outbound",
"is_direction_defaulted": false,
"AuditStatus": "Not Assigned",
"AuditScore": null,
"audit_date": null,
"auditor": null,
"Queues": [
{
"Queue ID": "qu-c304439-3d79-4389-b1cb-014eb75axxxx",
"Queue Name": "Default Queue - Q1"
}
],
"Agents": [
{
"Agent ID": "a-a25ad66-638d-46c0-b4db-7e5a7360xxxx",
"Agent Name": "John Doe"
}
],
"koreEvalutionScore": null,
"fatalErrorCount": 0,
"Language": "English",
"duration_status": "below_threshold",
"Metrics": [
{
"Metric ID": "em-44758b38-816c-557b-b6a9-2d2c6297xxxx",
"Metric Name": "UK Greeting Compliance Rate GEN",
"Metric Weight": 28,
"Metric Negative Weight": 27,
"isFatalError": false
},
{
"Metric ID": "em-dc5679bd-e6c4-548c-b650-21c5e83dxxxx",
"Metric Name": "UK Proper Sign-off GenAI",
"Metric Weight": 27,
"Metric Negative Weight": 26,
"isFatalError": false
}
]
},
{
"conversationId": "c-a19b658-da43-465c-9606-1abb5786xxxx",
"contact_direction": "inbound",
"is_direction_defaulted": false,
"AuditStatus": "Audited",
"AuditScore": 0,
"audit_date": "2026-03-23 15:10:00",
"auditor": "Jane Supervisor",
"Queues": [
{
"Queue ID": "qu-c304439-3d79-4389-b1cb-014eb75axxxx",
"Queue Name": "Default Queue - Q1"
}
],
"Agents": [
{
"Agent ID": "a-424ea65-322b-47c1-8189-7200b64cxxxx",
"Agent Name": "Lily Agent"
}
],
"koreEvalutionScore": 0,
"fatalErrorCount": 1,
"Language": "English",
"duration_status": "evaluated",
"Metrics": [
{
"Metric ID": "em-44758b38-816c-557b-b6a9-2d2c6297xxxx",
"Metric Name": "UK Greeting Compliance Rate GEN",
"Metric Weight": 28,
"Metric Negative Weight": 27,
"Qualification": "YES",
"isFatalError": false
},
{
"Metric ID": "em-dc5679bd-e6c4-548c-b650-21c5e83dxxxx",
"Metric Name": "UK Proper Sign-off GenAI",
"Metric Weight": 27,
"Metric Negative Weight": 26,
"Qualification": "NO",
"isFatalError": true
}
]
},
{
"conversationId": "c-94376d76-dbe2-59c6-8665-ea70217exxxx",
"customConversationId": "UATTranscripts_Mar23b",
"contact_direction": "inbound",
"is_direction_defaulted": false,
"AuditStatus": "Assigned",
"AuditScore": null,
"audit_date": null,
"auditor": null,
"Queues": [
{
"Queue ID": "qu-16c07483-765f-5e2e-a150-e5b66033xxxx",
"Queue Name": "PublicApiQueue"
}
],
"Agents": [
{
"Agent ID": "a-b35a99e-9c55-4d43-ac00-225169c9xxxx",
"Agent Name": "Johndoe UAT TitanAsh"
}
],
"koreEvalutionScore": 9,
"fatalErrorCount": 0,
"Language": "English",
"duration_status": "evaluated",
"Metrics": [
{
"Metric ID": "em-44758b38-816c-557b-b6a9-2d2c6297xxxx",
"Metric Name": "UK Greeting Compliance Rate GEN",
"Metric Weight": 11,
"Metric Negative Weight": 14,
"Qualification": "YES",
"isFatalError": false
},
{
"Metric ID": "em-dc5679bd-e6c4-548c-b650-21c5e83dxxxx",
"Metric Name": "UK Proper Sign-off GenAI",
"Metric Weight": 9,
"Metric Negative Weight": 12,
"Qualification": "NO",
"isFatalError": false
}
]
}
],
"totalResults": 21,
"hasMore": false,
"totalPages": 1
}
```
## Response Body Parameters
| Parameter | Description | Type |
| ----------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------- |
| `results` | A list of contact records. | array |
| `customConversationId` | External or custom conversation identifier; present only when set at ingestion. | string |
| `conversationId` | Unique interaction identifier. | string |
| `queues` | List of queue objects associated with the conversation. | array |
| `agents` | List of agents who participated in the conversation. | array |
| `agentEmail` | Agent email address. | string |
| `agentRecordings` or `customerRecordings` | Recording file URLs for agent or customer audio channels (mono or split-channel). | array |
| `Kore Evaluation Score` | AutoQA score; returns `NA` when not evaluated. | number or string |
| `fatalErrorCount` | Number of fatal errors detected. | number |
| `contact_direction` | Resolved interaction direction (`inbound` or `outbound`). | string (enum) |
| `is_direction_defaulted` | Indicates whether direction is system-inferred (`true`) or provided at ingestion (`false`). | boolean |
| `duration_status` | Evaluation eligibility status (`evaluated`, `below_threshold`, `duration_unavailable`). | string (enum) |
| `auditStatus` | Current audit status (`Audited`, `Assigned`, `Not Assigned`). | string |
| `auditScore` | Score assigned during audit evaluation; returned only when completed. | number (optional) |
| `audit_date` | Timestamp of audit completion. | DateTime or null |
| `auditor` | Name of the auditor. | string or null |
| `generatedIntents` | List of AI-detected intents. | array |
| `configuredIntents` | Taxonomy-based L1–L3 topic hierarchy results. | object |
| `speakingRate` | Speaking rate analysis entries. | array |
| `sentimentPattern` | Sentiment at start and end of conversation. | object |
| `emotions` | Customer or agent emotion breakdown with duration and proportion. | array |
| `sentimentRatio` | Distribution of sentiment (positive, neutral, negative). | object |
| `custom_fields` | Business-specific metadata from Express File or Agent AI. | object |
| `conversationStartTime` | UTC timestamp when the conversation started. | string |
| `conversationEndTime` | UTC timestamp when the conversation ended. | string |
| `language` | Conversation language. | string |
| `duration` | Conversation duration in milliseconds. | number |
| `sentiment` | Sentiment classification (e.g., positive, neutral). | string |
| `sentimentScore` | Overall sentiment score; returns `null` if unavailable. | number (null) |
| `totalResults` | Total number of records matching the request. | integer |
| `totalPages` | Total number of pages available. | integer |
| `hasMore` | Indicates whether additional pages exist. | boolean |
| `queueId` | Queue identifier of the conversation. | string |
| `queueName` | Name of the queue. | string |
| `agentId` | Unique agent identifier. | string |
| `agentName` | Name of the agent who participated. | string |
| `metrics` | List of evaluation metric objects. | array |
| `metricId` | Unique metric identifier. | string |
| `metricName` | Name of the evaluation metric. | string |
| `metricWeight` | Positive weight assigned to the metric. | number |
| `metricNegativeWeight` | Negative weight assigned; defaults to `0` if not configured. | number |
| `isFatalError` | Indicates whether the metric is fatal; if `true` and failed, score becomes `0`. | boolean |
| `qualification` | Metric evaluation result (`YES`, `NO`, `NA`). | string |