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

List call logs

Returns call logs, newest first.

GET/v2/call-logs

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.

Query parameters

  • limitinteger

    Maximum items to return (1-200).

    Default: 50
  • offsetinteger

    Items to skip, for paging.

    Default: 0
  • start_datestring (date-time)

    Only calls that started at or after this time (ISO 8601).

  • end_datestring (date-time)

    Only calls that started at or before this time (ISO 8601).

  • agent_idstring (uuid)

    Only calls handled by this agent.

Response

An array of call log objects. Each item is described in the call log object.

Request
curl --request GET \
  --url 'https://api.tarangnow.com/v2/call-logs?limit=20&start_date=2026-10-01T00%3A00%3A00Z' \
  --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"
  }
]
PreviousCall logs overviewNextGet call log