Skip to main content
GET
/
transcripts
/
agent
/
{agentId}
/
stats
Get Agent Stats
curl --request GET \
  --url https://voice-livekit.studio.lyzr.ai/v1/transcripts/agent/{agentId}/stats \
  --header 'x-api-key: <api-key>'
{
  "totalCalls": 1250,
  "browserCalls": 850,
  "phoneCalls": 400,
  "avgMessages": 14.5
}
Retrieve high-level, aggregated statistics about a specific Voice Agent’s performance and usage history. If you are building an analytics dashboard for your users, this endpoint is highly efficient. Instead of downloading every single transcript to calculate metrics locally, this endpoint instantly returns pre-calculated totals and averages directly from the server.
Authentication Required: You must include your API key in the x-api-key header to authenticate this request.

​
Required Parameters

  • agentId (Path Parameter): The 24-character unique identifier of the agent whose statistics you want to retrieve.

​
Understanding the Analytics Response

A successful 200 OK request returns a lightweight JSON object packed with actionable data:
  • totalCalls: The absolute volume of conversations this agent has handled since it was created.
  • browserCalls: How many of those calls originated from a web-based widget or browser interface.
  • phoneCalls: How many calls were routed through a telephony or SIP trunk integration (e.g., standard phone lines).
  • avgMessages: A great indicator of conversation depth. A higher average message count usually means the agent is successfully engaging users in longer, back-and-forth dialogue rather than quick drop-offs.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
agentId
string
required

The unique identifier of the agent.

Example:

"f790923795a23467555c0ad6"

Response

200 - application/json

Agent transcript statistics retrieved successfully.

​
totalCalls
integer

The total number of sessions handled by this agent.

Example:

1250

​
browserCalls
integer

The number of sessions initiated via a web browser interface.

Example:

850

​
phoneCalls
integer

The number of sessions initiated via a SIP/telephony integration.

Example:

400

​
avgMessages
number<float>

The average number of messages exchanged per session.

Example:

14.5