Auto QA Reporting API

Back to API List The Auto QA Score Reporting API returns interaction-level evaluation data, including Auto QA scores, metric results, duration-based eligibility, and audit details, with support for contact direction (inbound/outbound). It uses duration_status to indicate evaluation eligibility, supports date-range and pagination filters, and can include below-threshold interactions when requested. With direction-based evaluation, the API enables directional segmentation, applies direction-specific evaluation logic, and supports audit-level reporting.

METHOD	POST
Endpoint	`https://{{host}}/qualityai/api/v1/public/qualitymanagement/app/{{streamId}}/scorereporting`
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
`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

curl --location 'https://{{host}}/qualityai/api/v1/public/qualitymanagement/app/{{streamId}}/scorereporting' \
--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:36:35",
  "include_below_threshold": true,
  "contact_direction": "inbound"
  "limit": 100
}'

Body Parameters

Parameter	Description	Type
`offset`	Number of records to skip for pagination.	integer, optional
`startDate`	The start date from which records are retrieved. Use UTC format: `YYYY-MM-DDTHH:MM:SS.NNNZ`. For example, `2026-03-23 10:17:54`.	string, required
`endDate`	The end date to include records. Use UTC format: `YYYY-MM-DDTHH:MM:SS.NNNZ`. For example, `2026-03-23 23:00:35`.	string, required
`include_below_threshold`	When `true`, includes contacts marked Below Threshold in the response. Default: `false`.	string, required
`limit`	Number of records to retrieve per page (maximum `100`).	integer, optional
`contact_direction`	Filters results by `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",
      "customConversationId": "UATTranscripts_Mar23b",
      "contact_direction": "inbound",
      "channel": "voice",
      "audit_status": "audited",
      "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"
        }
      ],
      "koreEvalutionScore": 77,
      "supervisorAuditScore": 81,
      "fatalErrorCount": 0,
      "Language": "English",
      "duration_status": "evaluated",
      "evaluation_status": "pass",
      "evaluatedAt": "2026-03-23 11:03:54",
      "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": "YES",
          "isFatalError": false
        }
      ]
    },
    {
      "conversationId": "c-8d43539-ae1e-473a-ad97-6bd2add4xxxx",
      "contact_direction": "inbound",
      "channel": "voice",
      "audit_status": "not_audited",
      "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,
      "supervisorAuditScore": null,
      "fatalErrorCount": 0,
      "Language": "English",
      "duration_status": "below_threshold",
      "evaluation_status": "not_evaluated",
      "evaluatedAt": null,
      "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
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 100,
    "totalResults": 21,
    "hasMore": false,
    "totalPages": 1
  }
}

Response Body Parameters

Parameter	Description	Type
`results`	List of conversation objects returned for the request.	array
`conversationId`	Unique system-generated identifier for the conversation.	string
`customConversationId`	Custom identifier provided at ingestion time; present only when set during upload.	string
`queues`	List of queue objects associated with the conversation.	array
`queueId`	Unique identifier for the queue.	string
`queueName`	Name of the queue.	string
`agents`	List of agents who participated in the conversation; multiple agents may exist per conversation.	array
`agentId`	Unique identifier for the agent.	string
`agentName`	Name of the agent.	string
`koreEvaluationScore`	Auto QA score (-100 to 100); returns `null` for `below-threshold` or `unavailable duration`.	number or null
`fatalErrorCount`	Number of fatal metric failures; returns `0` when none are present. If a fatal error occurs, `koreEvaluationScore` is set to `0`.	integer
`language`	Conversation language.	string
`metrics`	List of evaluation metric objects applied to the conversation.	array
`metricId`	Unique identifier for the evaluation metric.	string
`metricName`	Name of the evaluation metric as configured in the evaluation form.	string
`metricWeight`	Positive weight assigned to the metric.	number
`metricNegativeWeight`	Negative weight assigned; returns `0` when not configured.	number
`qualification`	Agent outcome for the metric (`YES`, `NO`, `NA`); present only when `duration_status` is `evaluated`.	string (enum)
`isFatalError`	Indicates whether the metric is fatal and not met; if `true`, `koreEvaluationScore` is set to `0`.	boolean
`duration_status`	Evaluation eligibility status (`evaluated`, `below_threshold`, `duration_unavailable`).	string (enum)
`evaluation_status`	Overall evaluation result (`pass`, `fail`, `not_evaluated`).	string (enum)
`audit_status`	Status of audit assignment or completion; returns `null` if unavailable.	string or null
`contact_direction`	Resolved interaction direction (`inbound` or `outbound`).	string (enum)
`is_direction_defaulted`	Indicates whether direction was system-inferred (`true`) or provided at ingestion (`false`).	boolean or null
`channel`	Interaction channel (`voice` or `chat`).	string
`auditor`	Name of the auditor.	string or null
`AuditStatus`	Audit workflow 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
`evaluatedAt`	Timestamp when Auto QA evaluation was completed.	DateTime or null
`totalResults`	Total number of conversation records matching the request.	integer
`totalPages`	Total number of pages based on page size.	integer
`hasMore`	Indicates whether additional pages exist.	boolean
`results`	A list of conversation objects.	array

Contacts ingested before the minimum duration threshold feature is enabled return null for duration_status.

Modules

Platform Services

Administration

References

Header Parameters

Path Parameters

Sample Request

Body Parameters

Sample Response

Response Body Parameters

Modules

Platform Services

Administration

References

​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