API Reference
DashboardGet API keyAPI key

Getting started

  • Introduction
  • Authentication
  • Errors & rate limits

Voice agents

    • Overview
    • GETList call logs
    • GETGet call log
    • GETGet call stats

WhatsApp agents

Workspace

Voice agentsCall logs

Get call log

Retrieves one call log, including its transcript and recording URL.

GET/v2/call-logs/{id}

Authorization

  • Authorizationstringheaderrequired

    Bearer authentication header of the form Bearer <api_key>, where <api_key> is a key from Account Settings → API keys in your dashboard.

Path parameters

  • idstring (uuid)required

    The call log's id.

Response

The call log object.

Show all 18 fieldsHide fields
  • 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.

Request
curl --request GET \
  --url 'https://api.tarangnow.com/v2/call-logs/c1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c' \
  --header 'Authorization: Bearer <api_key>'
Response
{
  "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"
}
PreviousList call logsNextGet call stats