Get Conversation Statistics

curl --request GET \
  --url https://api.inya.ai/platform/v1/conversations/{conversationId}/stats \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.inya.ai/platform/v1/conversations/{conversationId}/stats"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.inya.ai/platform/v1/conversations/{conversationId}/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "<string>",
  "message": "Conversation details fetched successfully",
  "response": [
    {
      "conversationId": "<string>",
      "botId": "fb79920229d144608ebf665a10e50275",
      "botName": "Support Agent",
      "callDuration": 123,
      "startTime": 123,
      "endTime": 123,
      "callStatus": "completed",
      "callSummary": {
        "disposition": "<string>"
      },
      "utteranceAnalytics": [
        "<unknown>"
      ],
      "overallCallDisposition": "<string>",
      "averageAgentLatency": 123,
      "callProcessed": true,
      "lastProcessedOn": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

GET

conversations

{conversationId}

stats

Get Conversation Statistics

curl --request GET \
  --url https://api.inya.ai/platform/v1/conversations/{conversationId}/stats \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.inya.ai/platform/v1/conversations/{conversationId}/stats"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.inya.ai/platform/v1/conversations/{conversationId}/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "<string>",
  "message": "Conversation details fetched successfully",
  "response": [
    {
      "conversationId": "<string>",
      "botId": "fb79920229d144608ebf665a10e50275",
      "botName": "Support Agent",
      "callDuration": 123,
      "startTime": 123,
      "endTime": 123,
      "callStatus": "completed",
      "callSummary": {
        "disposition": "<string>"
      },
      "utteranceAnalytics": [
        "<unknown>"
      ],
      "overallCallDisposition": "<string>",
      "averageAgentLatency": 123,
      "callProcessed": true,
      "lastProcessedOn": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

Overview

Get comprehensive performance statistics and analytics for a specific conversation, including call duration, disposition, per-utterance analytics, and agent response latency. Use this endpoint to investigate individual conversations for quality assurance, coaching, or debugging.

Required Permission

conversations

Path Parameters

Name	Type	Required	Description
`conversationId`	string	Yes	Unique identifier of the conversation.

Example cURL

curl "https://api.inya.ai/platform/v1/conversations/conv_abc123/stats" \
  -H "x-api-key: <your_api_key>"

Response

Success (200)

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Conversation details fetched successfully",
  "response": [
    {
      "conversationId": "conv_abc123",
      "botId": "58f010d9e797494aae193fdc537a7c33",
      "botName": "Support Agent",
      "callDuration": 600,
      "startTime": 1752918000,
      "endTime": 1752918600,
      "callStatus": "completed",
      "callSummary": {
        "disposition": "resolved"
      },
      "utteranceAnalytics": [],
      "overallCallDisposition": "resolved",
      "averageAgentLatency": 1.5,
      "callProcessed": true,
      "lastProcessedOn": "2026-07-21T10:30:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
`conversationId`	string	Unique conversation identifier.
`botId`	string	Agent that handled this conversation.
`botName`	string	Display name of the agent.
`callDuration`	integer	Call duration in seconds.
`startTime`	integer	Unix timestamp (seconds) of call start.
`endTime`	integer	Unix timestamp (seconds) of call end.
`callStatus`	string	Final call status (e.g. `completed`, `failed`).
`callSummary.disposition`	string	Call outcome determined by the LLM.
`utteranceAnalytics`	array	Per-utterance analytics data.
`overallCallDisposition`	string	Aggregated call disposition.
`averageAgentLatency`	number	Average agent response time in seconds. Lower is better.
`callProcessed`	boolean	Whether the analytics pipeline has finished processing this conversation.
`lastProcessedOn`	string	ISO 8601 timestamp of the last analytics processing run.

Error Responses

403 Forbidden - Insufficient permissions

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "User does not have access to this conversation"
}

404 Not Found - Conversation does not exist

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Conversation not found"
}

Use Cases

Analyzing individual call performance and disposition
Reviewing agent response latency for optimization
Identifying conversations with unexpected outcomes for coaching
Compliance and audit review of recorded conversations

The averageAgentLatency metric is key to understanding agent responsiveness. A value above 2.0 seconds typically indicates LLM or TTS configuration that may benefit from optimization.

Check call_processed: true before relying on utterance_analytics. Processing happens asynchronously and may not be complete immediately after a call ends.

Save the requestId from every response. You will need it if you contact Inya support to trace a specific request.

Authorizations

x-api-key

string

header

required

API key with 'conversations' permission

Path Parameters

conversationId

string

required

Unique identifier of the conversation.

Response

Conversation statistics retrieved successfully

status

string

Example:

"success"

requestId

string

message

string

Example:

"Conversation details fetched successfully"

response

object[]

Show child attributes

Getting Started

Agents API

Conversations API

Agent Config API

Agent FAQ API

Chat SDK API

Reference

Get Conversation Statistics

Overview

Required Permission

Path Parameters

Example cURL

Response

Success (200)

Response Fields

Error Responses

Use Cases

Authorizations

Path Parameters

Response

​Overview

​Required Permission

​Path Parameters

​Example cURL

​Response

​Success (200)

​Response Fields

​Error Responses

​Use Cases

Authorizations

Path Parameters

Response

Overview

Required Permission

Path Parameters

Example cURL

Response

Success (200)

Response Fields

Error Responses

Use Cases