Get call history

GET

https://api.levrage.ai/v1/calls

GET

/v1/calls

import requests
url = "https://api.levrage.ai/v1/calls"
querystring = {"page":"1","page_size":"20","status":"completed","direction":"outbound"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "id": "call_a1b2c3d4e5f6",
      "session_id": "sess_f6e5d4c3b2a1",
      "phone_number": "+919876543210",
      "direction": "outbound",
      "status": "completed",
      "agent_id": "550e8400-e29b-41d4-a716-446655440000",
      "started_at": "2026-01-15T09:30:00+05:30",
      "ended_at": "2026-01-15T09:40:00+05:30",
      "duration_seconds": 600,
      "duration_minutes": 10,
      "agent_type": "finance_lead_qualifier",
      "sentiment": "positive",
      "handover": false,
      "call_summary": "Customer was interested in the personal loan product. Agreed to a follow-up call.",
      "call_end_reason": "agent_hangup",
      "ended_by": "agent",
      "details_collection": {
        "status": "completed",
        "score": 0.95,
        "collected_details": [
          "full_name",
          "monthly_income"
        ],
        "collected_values": {
          "full_name": "Rahul Sharma",
          "monthly_income": "75000"
        }
      },
      "recording_url": "https://objectstore.e2enetworks.net/novaworker-recordings/call_a1b2c3d4e5f6.wav",
      "ai_cost": 0.15,
      "telephony_cost": 0.3,
      "total_cost": 0.45,
      "created_at": "2026-01-15T09:30:00+05:30"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20,
  "has_more": false,
  "request_id": "req_a1b2c3d4e5f6",
  "timestamp": "2026-01-15T09:45:00+05:30",
  "success": true
}

Get paginated call history with comprehensive filters.

Filters:

status: completed, failed, no_answer, voicemail
phone_number: partial match
agent_id: specific agent
from_date/to_date: date range
direction: inbound/outbound
sentiment: positive/neutral/negative
min_duration/max_duration: duration range in seconds
call_end_reason: user_hangup, agent_hangup, timeout
handover: true/false

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerOptional>=1Defaults to 1

Page number

page_sizeintegerOptional1-100Defaults to 20

Items per page

statusstring or nullOptional

completed, failed, no_answer, voicemail

phone_numberstring or nullOptional

Filter by phone number (partial match)

agent_idstring or nullOptional

Filter by agent ID

from_datestring or nullOptional

Start: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS

to_datestring or nullOptional

End: YYYY-MM-DD (the whole day) or YYYY-MM-DDTHH:MM:SS

directionstring or nullOptional

inbound or outbound

sentimentstring or nullOptional

positive, neutral, negative

agent_typestring or nullOptional

Filter by agent type

min_durationinteger or nullOptional>=0

Min duration in seconds

max_durationinteger or nullOptional>=0

Max duration in seconds

call_end_reasonstring or nullOptional

user_hangup, agent_hangup, timeout

handoverboolean or nullOptional

Filter by handover status

campaign_idstring or nullOptional

Only one campaign’s calls (GET /campaigns), callbacks to it included

Response

Successful Response

datalist of objects

totalinteger

pageinteger

page_sizeinteger

has_moreboolean

request_idstring

timestampdatetime

successbooleanOptionalDefaults to true

Errors

422

Unprocessable Entity Error