> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-apis.mintlify.site/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, including evaluation metrics, sentiment, emotions, duration status, intents (L1–L3 hierarchy, confidence, sentiment, resolution), custom fields, disposition, audit data, voice-specific metrics, and complete interaction context.
Audit data includes audit status, audit date, auditor, and audit responses by metric, enabling teams to analyze AutoQA and ManualQA results, track audits, generate reports, and perform advanced analytics. Additional fields such as contact direction, audit workflow details, and recording links enhance reporting, compliance monitoring, and operational insights.
| **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 |
## 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 in ISO 8601 format. | String, required |
| `endDate` | The end date to include records in ISO 8601 format. | 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. By default, the API excludes contacts below the configured minimum duration. To include them, set include\_below\_threshold=true. | 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 expandable=true theme={null}
{
"results": [
{
"src": "rtm",
"customConversationId": "UATMa2c********0A4",
"contactDirection": "inbound",
"Conversation ID": "c-de2dd02c********30590459421",
"Disposition": [
{
"setId": "dst-57b825e-cea1-4643-9b3c-4d24538xxxxx",
"setName": "Resolution",
"code": [
{
"id": "ds-e73c46c-c826-4294-b326-ae94429xxxxxx",
"name": "Requires Supervisor Attention",
"colour": "#800080"
}
]
},
{
"setId": "dst-d8863d8-9cb2-4a3d-a132-79983c4xxxxx",
"setName": "set2",
"code": []
}
],
"Conversation Start Time": "2026-05-02T13:01:34.000Z",
"Conversation End Time": "2026-05-02T13:03:13.000Z",
"Language": "English",
"Duration": "99000 milliseconds",
"Sentiment Score": 1.78,
"Queues": [
{
"Queue ID": "qu-321bc8a2c********b081d",
"Queue Name": "Expressq11"
}
],
"Agents": [
{
"agentId": "a-6470432c********688",
"Agent Name": "xxxxx xxxxx",
"Agent Start Time": "2026-05-02T13:01:34.000Z",
"Empathy Score": 0,
"Agent Email": "john.doe@example.com"
}
],
"Kore Evaluation Score": 35,
"IsChurnRiskObserved": false,
"IsEscalationObserved": false,
"Fatal Errors": 0,
"Emotions": [
"Happy",
"Neutral"
],
"Taxonomy Resolution": "YES",
"Audit Status": "Unassigned",
"Audit Date": null,
"Auditor Name": null,
"duration_status": "evaluated",
"Sentiment Pattern": {
"start": "neutral",
"end": "neutral"
},
"Customer emotions": [
{
"emotion": "Happy",
"duration": 0,
"proportion": 56.25
}
],
"Agent emotions": [
{
"emotion": "Patience",
"duration": 0,
"proportion": 85
}
],
"Sentiment Ratio": {
"positive": 28,
"neutral": 50,
"negative": 22
},
"Metrics": [
{
"Metric ID": "em-1dea972c********5a6",
"Metric Name": "Dyn batching -1",
"Qualification": "NA",
"isFatalError": false,
"triggerJustification": [],
"justification": []
},
{
"Metric ID": "em-598f22b2c********ac6e",
"Metric Name": "Agent xxxx",
"Qualification": "YES",
"isFatalError": false,
"justification": [
{
"message_id": [
"ms-ae818432c********6d4c"
],
"timestamp": [
1777726914000
],
"justification": "Sample justification"
}
]
}
],
"Pass Score": 40,
"IsPassed": false,
"Evaluation Form Name": "Dyn Batching EV",
"Evaluation Form Scoring Type": "percentage",
"Generated Intents": [
{
"intent": "check the current bank interest rate linked to the user account",
"keywords": [
"bank interest rate",
"registered mobile number",
"3.5%"
],
"Sentiment": "positive",
"Sentiment Score": 8,
"emotions": [
"Happy"
]
}
],
"Configured_Intents": {
"topics": [
{
"topic_name": "Core Banking Inquiry",
"level": "L1",
"confidence_score": 0.95,
"L2_topics": [
{
"topic_name": "Account Details",
"confidence_score": 0.9,
"L3_topics": [
{
"topic_name": "Get Interest Rate on Account",
"confidence_score": 0.95,
"sentiment": 8,
"resolution": 1
}
]
}
]
}
],
"total_topics_identified": 10
},
"custom_fields": {
"Duration_minutes": "7",
"CallType": "CLINumber",
"Region": "US"
}
}
],
"totalResults": 191,
"hasMore": true,
"totalPages": 96
}
```
## Response Body Parameters
| Parameter | Type | Description |
| ------------------------------ | ------- | ------------------------------------------------------------------------------- |
| `results` | Array | List of conversation evaluation records that match the request criteria. |
| `src` | String | Source of the conversation data. |
| `customConversationId` | String | Unique custom identifier associated with the conversation. |
| `contactDirection` | String | Direction of the interaction. Possible values include `inbound` and `outbound`. |
| `Conversation ID` | String | Unique identifier of the conversation. |
| `Disposition` | Array | Disposition sets associated with the conversation. |
| `setId` | String | Unique identifier of the disposition set. |
| `setName` | String | Name of the disposition set. |
| `code` | Array | List of selected disposition codes. |
| `id` | String | Unique identifier of the disposition code. |
| `name` | String | Name of the disposition code. |
| `colour` | String | Hexadecimal color associated with the disposition code. |
| `Conversation Start Time` | String | Timestamp when the conversation started in ISO 8601 format. |
| `Conversation End Time` | String | Timestamp when the conversation ended in ISO 8601 format. |
| `Language` | String | Language used during the conversation. |
| `Duration` | String | Total conversation duration in milliseconds. |
| `Sentiment Score` | Number | Overall sentiment score calculated for the conversation. |
| `Queues` | Array | Queues associated with the conversation. |
| `Queue ID` | String | Unique identifier of the queue. |
| `Queue Name` | String | Name of the queue. |
| `Agents` | Array | List of agents who participated in the conversation. |
| `agentId` | String | Unique identifier of the agent. |
| `Agent Name` | String | Name of the agent. |
| `Agent Start Time` | String | Timestamp when the agent joined the conversation in ISO 8601 format. |
| `Empathy Score` | Number | Empathy score assigned to the agent. |
| `Agent Email` | String | Email address of the agent. |
| `Kore Evaluation Score` | Number | Overall evaluation score assigned by the evaluation engine. |
| `IsChurnRiskObserved` | Boolean | Indicates whether churn risk was detected during the conversation. |
| `IsEscalationObserved` | Boolean | Indicates whether an escalation was detected during the conversation. |
| `Fatal Errors` | Integer | Number of fatal errors identified during evaluation. |
| `Emotions` | Array | List of emotions detected in the conversation. |
| `Taxonomy Resolution` | String | Indicates whether the conversation was successfully mapped to a taxonomy. |
| `Audit Status` | String | Audit assignment status of the conversation. |
| `Audit Date` | String | Date when the audit was completed in ISO 8601 format. |
| Auditor Name | String | Name of the auditor assigned to the conversation. |
| `duration_status` | String | Evaluation status of the duration threshold. |
| `Sentiment Pattern` | Object | Sentiment trend observed throughout the conversation. |
| `start` | String | Sentiment detected at the beginning of the conversation. |
| `end` | String | Sentiment detected at the end of the conversation. |
| `Customer emotions` | Array | Detailed customer emotion analysis. |
| `emotion` | String | Detected emotion. |
| `duration` | Number | Duration for which the emotion was observed. |
| `proportion` | Number | Percentage of the conversation during which the emotion was observed. |
| `Agent emotions` | Array | Detailed agent emotion analysis. |
| `Sentiment Ratio` | Object | Distribution of sentiment classifications. |
| `positive` | Number | Percentage of positive sentiment. |
| `neutral` | Number | Percentage of neutral sentiment. |
| `negative` | Number | Percentage of negative sentiment. |
| `Metrics` | Array | Evaluation metrics associated with the conversation. |
| `Metric ID` | String | Unique identifier of the evaluation metric. |
| `Metric Name` | String | Name of the evaluation metric. |
| `Qualification` | String | Qualification result for the metric. |
| `isFatalError` | Boolean | Indicates whether the metric is classified as a fatal error. |
| `triggerJustification` | Array | Trigger evidence associated with the metric. |
| `justification` | Array | Supporting evidence and justification details for the metric result. |
| `message_id` | Array | Message identifiers associated with the justification. |
| `timestamp` | Array | Epoch timestamps associated with the justification. |
| `Pass Score` | Number | Minimum score required to pass the evaluation. |
| `IsPassed` | Boolean | Indicates whether the conversation passed the evaluation criteria. |
| `Evaluation Form Name` | String | Name of the evaluation form used for scoring. |
| `Evaluation Form Scoring Type` | String | Scoring methodology used by the evaluation form. |
| `Generated Intents` | Array | AI-generated intents identified in the conversation. |
| `intent` | String | Generated intent description. |
| `keywords` | Array | Keywords associated with the generated intent. |
| `Sentiment` | String | Sentiment associated with the intent. |
| `Configured_Intents` | Object | Hierarchical taxonomy topics identified for the conversation. |
| `topics` | Array | List of identified topics. |
| `topic_name` | String | Name of the identified topic. |
| `level` | String | Topic hierarchy level. |
| `confidence_score` | Number | Confidence score assigned to the topic. |
| `L2_topics` | Array | Level 2 topics associated with the parent topic. |
| `L3_topics` | Array | Level 3 topics associated with the parent topic. |
| `sentiment` | Number | Sentiment score associated with the topic. |
| `resolution` | Number | Resolution status associated with the topic. |
| `total_topics_identified` | Integer | Total number of topics identified for the conversation. |
| `custom_fields` | Object | Custom fields configured for the conversation. |
| `Duration_minutes` | String | Conversation duration in minutes. |
| `CallType` | String | Custom call type associated with the conversation. |
| `Region` | String | Region associated with the conversation. |
| `totalResults` | Integer | Total number of records that match the request criteria. |
| `hasMore` | Boolean | Indicates whether additional records are available. |
| `totalPages` | Integer | Total number of available result pages. |