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": "ANSWERED",
      "callSummary": {
        "disposition": "resolved"
      },
      "utteranceAnalytics": [
        {
          "role": "user",
          "content": "how much is my due amount",
          "timestamp": 1786433699.931499,
          "detectedLanguage": "english",
          "totalResults": {
            "en-IN": "how much is my due amount",
            "hi-IN": "हाउ मच इज़ माइ ड्यू अमाउंट"
          },
          "userInterruptionFlag": false
        }
      ],
      "overallCallDisposition": "PTP",
      "averageAgentLatency": 123,
      "callProcessed": true,
      "lastProcessedOn": "2023-11-07T05:31:56Z"
    }
  ]
}

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

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

{
  "status": "failure",
  "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": "ANSWERED",
      "callSummary": {
        "disposition": "resolved"
      },
      "utteranceAnalytics": [
        {
          "role": "user",
          "content": "how much is my due amount",
          "timestamp": 1786433699.931499,
          "detectedLanguage": "english",
          "totalResults": {
            "en-IN": "how much is my due amount",
            "hi-IN": "हाउ मच इज़ माइ ड्यू अमाउंट"
          },
          "userInterruptionFlag": false
        }
      ],
      "overallCallDisposition": "PTP",
      "averageAgentLatency": 123,
      "callProcessed": true,
      "lastProcessedOn": "2023-11-07T05:31:56Z"
    }
  ]
}

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

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

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

What it does: Returns everything about one call — whether the phone connected, the business outcome code, and the full transcript. You need: A conversationId from Get Conversation Logs or a post-call webhook (conversation_id). After Trigger Call, poll Logs with your clientReferenceId to find the conversationId.

Required Permission

conversations

Path Parameters

Name	Required	Description
`conversationId`	Yes	From Logs or webhook. Not returned directly by Trigger Call.

Minimum working example

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

The three fields developers ask about

Calls produce three different kinds of outcome data. They answer different questions:

Field	Plain English	Example	Use it for
`callStatus`	Did the phone connect?	`"ANSWERED"`, `"NO ANSWER"`	Telephony dashboards — was the call picked up?
`overallCallDisposition`	What was the business result? Short code.	`"PTP"`, `"RNR"`, `"DSCN"`	CRM updates, campaign reports, filtering
`callSummary.disposition`	LLM-written label in plain language. May be `null`.	`"resolved"`, `"escalated"`	Human-readable summaries for QA review
`utteranceAnalytics`	What was actually said, turn by turn.	`[{ role, content, timestamp, … }]`	Transcripts, compliance, debugging

Call ends
   │
   ├─ callStatus              → "Did they pick up?"          (telephony)
   ├─ overallCallDisposition  → "What happened commercially?" (short code — PTP, RNR…)
   ├─ callSummary.disposition → "How would an LLM describe it?" (optional, may be null)
   └─ utteranceAnalytics      → "What was said word for word?"  (full transcript)

`overallCallDisposition` — what is it?

A short outcome code assigned after the call, based on your agent’s disposition configuration. It is not a sentence — it is a token you map in your CRM and reporting pipeline.

Disposition codes

Standard overallCallDisposition values:

Code	Meaning
`PTP`	Promise to Pay
`RTP`	Refused to Pay
`AP`	Already Paid
`CLBK`	Callback Requested
`WRNG`	Wrong Number
`DSCN`	Call Disconnected
`RNR`	No Answer
`DND`	Do Not Disturb

Your agent’s disposition prompt may produce additional codes beyond this list. Treat unknown values as opaque strings and log them for mapping. The same code appears as STAGE_CODE and inside disposition_result in post-call webhooks (snake_case) — see Update Agent — Post-call webhook.

`callSummary` — what is it?

An optional LLM-generated wrapper. When present, callSummary.disposition gives a human-readable label (e.g. "resolved"). When analytics have not finished processing, callSummary is null — this is normal on recent calls. Use overallCallDisposition for programmatic logic. Use callSummary.disposition only when you need a readable label and the object is present.

`utteranceAnalytics` — what is it?

The full conversation transcript as an array of turns. Each entry has:

Sub-field	On	Description
`role`	All turns	`"assistant"` or `"user"`
`content`	All turns	What was spoken
`timestamp`	All turns	Unix timestamp (seconds, may include fractions)
`detectedLanguage`	User turns	Language detected — e.g. `"english"`
`totalResults`	User turns	Transcript in each configured language
`userInterruptionFlag`	User turns	Whether the user interrupted the agent

Same shape as transcript in Logs, but Stats always returns the complete record.

Post-call webhooks deliver the same data in snake_case (conversation_id, detected_language, STAGE_CODE). See Update Agent — Post-call webhook for the webhook payload and field mapping.

Response

Success (200)

Verified example:

{
  "status": "success",
  "message": "Conversation details fetched successfully",
  "response": [
    {
      "userId": "29be0f97-51c6-49aa-a515-e0433649e69d",
      "bot": "fbec81f5c97c4a62b0103e87f53c0d56",
      "botName": "Muthoot-sanity_outbound_",
      "conversationId": "1786433682702486082",
      "startTime": 1786433683,
      "endTime": 1786433770,
      "callStatus": "ANSWERED",
      "callDuration": 81,
      "overallCallDisposition": "PTP",
      "utteranceAnalytics": [
        {
          "role": "assistant",
          "content": "Hi,shyam1234 how are you doing just want to known did you pay the EMI due amount?",
          "timestamp": 1786433683.312441
        },
        {
          "role": "user",
          "content": "how much is my due amount",
          "timestamp": 1786433699.931499,
          "totalResults": {
            "en-IN": "how much is my due amount",
            "hi-IN": "हाउ मच इज़ माइ ड्यू अमाउंट"
          },
          "detectedLanguage": "english",
          "userInterruptionFlag": false
        },
        {
          "role": "assistant",
          "content": "Hello, am I speaking with Nani?",
          "timestamp": 1786433700.549843
        },
        {
          "role": "user",
          "content": "yes you are",
          "timestamp": 1786433705.403072,
          "totalResults": {
            "en-IN": "yes you are",
            "hi-IN": "येस शुर"
          },
          "detectedLanguage": "english",
          "userInterruptionFlag": false
        },
        {
          "role": "assistant",
          "content": "I'm Viraj calling from Muthoot Capital. I'm just calling to check in with you. Your loan payment of [due_amount] was due on [due_date], and we noticed it hasn't come through yet. I wanted to understand if there was any delay or difficulty from your side?",
          "timestamp": 1786433706.562911
        },
        {
          "role": "user",
          "content": "actually i will be paying it today",
          "timestamp": 1786433722.501854,
          "totalResults": {
            "en-IN": "actually i will be paying it today",
            "hi-IN": "अक्चवली आई विल बी पेइंग इट टुडे"
          },
          "detectedLanguage": "english",
          "userInterruptionFlag": false
        },
        {
          "role": "assistant",
          "content": "That is great to hear. Just to check, was there any specific reason for the delay this time?",
          "timestamp": 1786433723.086668
        },
        {
          "role": "user",
          "content": "my salary got delayed",
          "timestamp": 1786433734.365692,
          "totalResults": {
            "en-IN": "my salary got delayed",
            "hi-IN": "माय सैलरी गॉट डिलेड"
          },
          "detectedLanguage": "english",
          "userInterruptionFlag": false
        },
        {
          "role": "assistant",
          "content": "I understand. Salary delays can happen sometimes. Thank you for letting me know. Just to keep you informed, When a payment is missed, It may have a small impact on your credit score. Also, As per the loan terms, Late payment charges may be applied. That is why we reach out early, So you can avoid any extra charges.",
          "timestamp": 1786433735.428127
        },
        {
          "role": "user",
          "content": "okay thank you for that bye",
          "timestamp": 1786433757.258117,
          "totalResults": {
            "en-IN": "okay thank you for that bye",
            "hi-IN": "ओके थैंक यू फॉर दैट बाई"
          },
          "detectedLanguage": "english",
          "userInterruptionFlag": false
        },
        {
          "role": "assistant",
          "content": "Since you mentioned you will be paying today, I will just make a small note of it. Thank you for your time, Nani. If you need any assistance, Please feel free to reach out. Have a good day. Thank you, Have a nice day.",
          "timestamp": 1786433761.166623
        }
      ],
      "botId": "fbec81f5c97c4a62b0103e87f53c0d56"
    }
  ],
  "requestId": "ed1c4163-8841-4316-9b27-68f20296537c"
}

callSummary, averageAgentLatency, callProcessed, and lastProcessedOn are not shown above because they are populated asynchronously and may be absent on recent calls. When present:

"callSummary": { "disposition": "resolved" },
"averageAgentLatency": 1.2,
"callProcessed": true,
"lastProcessedOn": "2026-08-11T10:30:00Z"

All response fields

Field	Type	Description
`conversationId`	string	Unique call identifier.
`botId`	string	Agent that handled this call.
`botName`	string	Agent display name.
`callDuration`	number	Length in seconds. `0` when the call was not answered.
`startTime` / `endTime`	number	Unix timestamps (seconds).
`callStatus`	string	Telephony outcome — `ANSWERED`, `NO ANSWER`, etc.
`overallCallDisposition`	string	Business outcome code — see Disposition codes.
`callSummary`	object \| null	LLM summary. `null` until analytics finish.
`callSummary.disposition`	string	Human-readable LLM label when present.
`utteranceAnalytics`	array	Full turn-by-turn transcript.
`averageAgentLatency`	number \| null	Mean agent response time in seconds. May be absent.
`callProcessed`	boolean \| null	`true` when analytics pipeline finished. May be absent.
`lastProcessedOn`	string \| null	ISO 8601 timestamp of last analytics run.

Edge cases

Scenario	What happens
Call just ended	`overallCallDisposition` and `utteranceAnalytics` available; `callSummary` may still be `null`
Call not answered	`callStatus: "NO ANSWER"`, `callDuration: 0`, disposition often `RNR`
Analytics still running	Retry after 30–60 seconds, or use post-call webhook for immediate push
`averageAgentLatency` above 2s	Often indicates LLM or TTS settings worth tuning

Errors

403 Forbidden

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

404 Not Found

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

Save the requestId from every response. You will need it if you contact Gnani 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

Required Permission

Path Parameters

Minimum working example

The three fields developers ask about

`overallCallDisposition` — what is it?

Disposition codes

`callSummary` — what is it?

`utteranceAnalytics` — what is it?

Response

Success (200)

All response fields

Edge cases

Errors

Authorizations

Path Parameters

Response

​Required Permission

​Path Parameters

​Minimum working example

​The three fields developers ask about

​overallCallDisposition — what is it?

​Disposition codes

​callSummary — what is it?

​utteranceAnalytics — what is it?

​Response

​Success (200)

​All response fields

​Edge cases

​Errors

Authorizations

Path Parameters

Response

Required Permission

Path Parameters

Minimum working example

The three fields developers ask about

`overallCallDisposition` — what is it?

Disposition codes

`callSummary` — what is it?

`utteranceAnalytics` — what is it?

Response

Success (200)

All response fields

Edge cases

Errors