Voice agentsCall logs

Call logs

Read every call your agents handled -- transcripts, summaries, recordings and cost.

A call log is written when a call ends, for inbound, outbound, web and WhatsApp calls. Logs are read-only through the API.

Use the stats endpoint for totals over a date range instead of paging through every log.

Endpoints

GETList call logs/call-logsGETGet call log/call-logs/{id}GETGet call stats/call-logs/stats

The call log object

idstring (uuid)
Unique identifier of the call log.
agent_idstring (uuid)nullable
Agent that handled the call.
number_idstring (uuid)nullable
Your phone number the call was on.
call_uuidstringnullable
The telephony provider's call id.
directionstringnullable
inbound or outbound.
call_typestringnullable
Channel of the call.
Allowed:phone_callweb_callwhatsapp_call
caller_numberstringnullable
The other party's phone number.
statusstringnullable
Final status of the call, e.g. completed, no-answer, busy.
duration_secondsintegernullable
Call length in seconds.
summarystringnullable
AI summary of the conversation.
transcriptstringnullable
Full transcript.
costnumbernullable
Amount charged to your wallet for the call.
hangup_bystringnullable
Who ended the call.
started_atstring (date-time)nullable
When the call started.
ended_atstring (date-time)nullable
When the call ended.
recording_urlstringnullable
URL of the call recording.
analysis_statusstringnullable
Post-call analysis: processing, done, failed, or null if not analysed.
created_atstring (date-time)
When the log was created.

{ "id": "c1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c", "number_id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a", "agent_id": "3f6c2b1e-8a4d-4c5e-9b2a-1d7e6f8a9b0c", "call_uuid": "1c9a7e2e-6b0f-4f4e-a1a8-9d0f0b2c3e4d", "direction": "inbound", "call_type": "phone_call", "caller_number": "+919876543210", "status": "completed", "duration_seconds": 184, "summary": "Caller wants a ₹45L home loan in Pune. Callback booked for Friday 11 AM.", "transcript": "Agent: Hi, this is Priya from Acme Finance...\nUser: Hi, I wanted to know about home loans...", "cost": 9.2, "hangup_by": "user", "started_at": "2026-10-24T10:02:11Z", "ended_at": "2026-10-24T10:05:15Z", "created_at": "2026-10-24T10:05:16Z", "recording_url": "https://media.tarangnow.com/recordings/1c9a7e2e.mp3", "analysis_status": "done" }

The call log object

idstring (uuid)

Unique identifier of the call log.

agent_idstring (uuid)nullable

Agent that handled the call.

number_idstring (uuid)nullable

Your phone number the call was on.

call_uuidstringnullable

The telephony provider's call id.

directionstringnullable

inbound or outbound.

call_typestringnullable

Channel of the call.

Allowed:phone_callweb_callwhatsapp_call

caller_numberstringnullable

The other party's phone number.

statusstringnullable

Final status of the call, e.g. completed, no-answer, busy.

duration_secondsintegernullable

Call length in seconds.

summarystringnullable

AI summary of the conversation.

transcriptstringnullable

Full transcript.

costnumbernullable

Amount charged to your wallet for the call.

hangup_bystringnullable

Who ended the call.

started_atstring (date-time)nullable

When the call started.

ended_atstring (date-time)nullable

When the call ended.

recording_urlstringnullable

URL of the call recording.

analysis_statusstringnullable

Post-call analysis: processing, done, failed, or null if not analysed.

created_atstring (date-time)

When the log was created.