v1

latestOpenAPI 3.1.0MIT License2026-07-17121547.4 KB
Call Management
Call Management

List Calls

Retrieve a paginated list of calls with optional filtering.

Supports:
- Pagination with page and limit parameters
- Filtering by call status
- Sorting by creation time (newest first)
get/api/v1/calls/

Query parameters

pageinteger

Page number (1-based)

Page number (1-based)

limitinteger

Number of items per page (1-100)

Number of items per page (1-100)

status_filter'initiating' | 'ringing' | 'connected' | 'on_hold' | 'disconnected' | 'failed' nullable

Filter calls by status

Filter calls by status

Response

Calls retrieved successfully

totalinteger required

Total number of calls matching criteria

pageinteger

Current page number (1-based)

limitinteger

Number of items per page

Example response

{
  "calls": [
    {
      "call_id": "call_abc12345",
      "duration": 120,
      "events": [],
      "participants": [],
      "status": "connected"
    }
  ],
  "limit": 10,
  "page": 1,
  "total": 25
}