List Calls | Conversive | Documentation

{
  "page": 1,
  "page_size": 20,
  "total": 2,
  "items": [
    {
      "call_id": "550e8400-e29b-41d4-a716-446655440000",
      "account_id": "152",
      "external_call_id": null,
      "direction": "outbound",
      "call_mode": "human",
      "call_type": "browser",
      "outgoing_number": "+912264237758",
      "agent_number": null,
      "customer_number": "+919580440262",
      "status": "completed",
      "disconnect_reason": "call completed",
      "started_at": "2026-04-28T10:30:00",
      "answered_at": "2026-04-28T10:30:10",
      "ended_at": "2026-04-28T10:35:00",
      "recording_link": "recordings/file.mp3",
      "duration_seconds": 290,
      "transcription": null,
      "transcription_status": null,
      "created_at": "2026-04-28T10:30:00",
      "updated_at": "2026-04-28T10:35:00"
    }
  ]
}

Fetch paginated call history for the authenticated account. Optionally filter results to calls involving one or more specific customer phone numbers.

Authentication

AuthorizationBearer

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

Query parameters

pageintegerOptionalDefaults to 1

Page number (1-based).

page_sizeintegerOptional<=100Defaults to 20

Number of records per page. Maximum is 100.

customer_numbersstringOptional

Comma-separated list of customer phone numbers in E.164 format. URL-encode + as %2B and , as %2C.

Response

Paginated list of call records.

pageintegerOptional

Current page number.

page_sizeintegerOptional

Number of records in this response.

totalintegerOptional

Total number of calls matching the query.

itemslist of objectsOptional

Errors

401

Unauthorized Error