Skip to main content
Back to 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.
METHODPOST
Endpointhttps://{{host}}/qualityai/api/v1/public/qualitymanagement/app/{{streamId}}/rawdata
Content Typeapplication/json
Authorizationauth: {{JWT}} — See How to generate the JWT Token.
API ScopeQuality Management Analytics.

​
Header Parameters

ParameterDescriptionType
Content-Typeapplication/jsonstring, required
accountIdUnique account identifier. For example, 67a9ca06cf0e510a8632xxxxstring, required
orgIdUnique identifier of the organization.string, required
authJWT token used for authentication.string, required

​
Path Parameters

ParameterDescriptionType
hostEnvironment URL. For example, https://platform.kore.ai/string, required
streamIdbotId 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

ParameterDescriptionType
offsetNumber of records to skip for pagination.integer, required
startDateThe start date to include records. Use UTC format: YYYY-MM-DDTHH24:MM:SS. For example, 2026-03-23 10:17:54.string, required
endDateThe end date to include records. Use UTC format: YYYY-MM-DDTHH24:MM:SS. For example, 2026-03-23 23:00:35.string, required
limitThe number of conversation records to return. The default is 10.integer, optional
pageThe page number for pagination. The default value is 1.integer, optional
include_below_thresholdIncludes below-threshold contacts.boolean (optional)
custom_fieldsBusiness-specific metadata filters.object (optional)
contact_directionResolved 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": [
    {
      "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

ParameterDescriptionType
resultsA list of contact records.array
customConversationIdExternal or custom conversation identifier; present only when set at ingestion.string
conversationIdUnique interaction identifier.string
queuesList of queue objects associated with the conversation.array
agentsList of agents who participated in the conversation.array
agentEmailAgent email address.string
agentRecordings or customerRecordingsRecording file URLs for agent or customer audio channels (mono or split-channel).array
Kore Evaluation ScoreAutoQA score; returns NA when not evaluated.number or string
fatalErrorCountNumber of fatal errors detected.number
contact_directionResolved interaction direction (inbound or outbound).string (enum)
is_direction_defaultedIndicates whether direction is system-inferred (true) or provided at ingestion (false).boolean
duration_statusEvaluation eligibility status (evaluated, below_threshold, duration_unavailable).string (enum)
auditStatusCurrent audit status (Audited, Assigned, Not Assigned).string
auditScoreScore assigned during audit evaluation; returned only when completed.number (optional)
audit_dateTimestamp of audit completion.DateTime or null
auditorName of the auditor.string or null
generatedIntentsList of AI-detected intents.array
configuredIntentsTaxonomy-based L1–L3 topic hierarchy results.object
speakingRateSpeaking rate analysis entries.array
sentimentPatternSentiment at start and end of conversation.object
emotionsCustomer or agent emotion breakdown with duration and proportion.array
sentimentRatioDistribution of sentiment (positive, neutral, negative).object
custom_fieldsBusiness-specific metadata from Express File or Agent AI.object
conversationStartTimeUTC timestamp when the conversation started.string
conversationEndTimeUTC timestamp when the conversation ended.string
languageConversation language.string
durationConversation duration in milliseconds.number
sentimentSentiment classification (e.g., positive, neutral).string
sentimentScoreOverall sentiment score; returns null if unavailable.number (null)
totalResultsTotal number of records matching the request.integer
totalPagesTotal number of pages available.integer
hasMoreIndicates whether additional pages exist.boolean
queueIdQueue identifier of the conversation.string
queueNameName of the queue.string
agentIdUnique agent identifier.string
agentNameName of the agent who participated.string
metricsList of evaluation metric objects.array
metricIdUnique metric identifier.string
metricNameName of the evaluation metric.string
metricWeightPositive weight assigned to the metric.number
metricNegativeWeightNegative weight assigned; defaults to 0 if not configured.number
isFatalErrorIndicates whether the metric is fatal; if true and failed, score becomes 0.boolean
qualificationMetric evaluation result (YES, NO, NA).string