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 stats

Totals for every call in a date range. Omit both dates for all time.

GET/v2/call-logs/stats

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

  • start_datestring (date-time)

    Range start (ISO 8601), on started_at.

  • end_datestring (date-time)

    Range end (ISO 8601), on started_at.

Response

Aggregated call statistics.

  • total_callsinteger

    Number of calls.

  • total_duration_secondsinteger

    Sum of call durations.

  • total_costnumber

    Sum of call costs.

  • by_statusobject

    Call count per status, e.g. {"completed": 120}.

Request
curl --request GET \
  --url 'https://api.tarangnow.com/v2/call-logs/stats?start_date=2026-10-01T00%3A00%3A00Z&end_date=2026-10-31T23%3A59%3A59Z' \
  --header 'Authorization: Bearer <api_key>'
Response
{
  "total_calls": 142,
  "total_duration_seconds": 21480,
  "total_cost": 1094.6,
  "by_status": {
    "completed": 118,
    "no-answer": 17,
    "busy": 7
  }
}
PreviousGet call logNextWhatsApp accounts overview