Raw Data API - Kore.ai Docs

Back to 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.
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

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

{
  "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.

​Header Parameters

​Path Parameters

​Sample Request

​Body Parameters

​Sample Response

​Response Body Parameters

Header Parameters

Path Parameters

Sample Request

Body Parameters

Sample Response

Response Body Parameters