List call logs

Retrieve call logs for the authenticated user.

This endpoint uses cursor-based pagination for efficient traversal of large datasets. Use the cursor value from the response to fetch the next page.

GET /calls

List call logs

cURL

curl --request GET \
  --url https://api.omnia-voice.com/api/v1/calls \
  --header 'X-API-Key: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "duration": 123,
      "durationMs": 123,
      "durationSeconds": 123,
      "status": "<string>",
      "summary": "<string>",
      "shortSummary": "<string>",
      "transcript": "<string>",
      "billing": {
        "durationMinutes": 123,
        "costCents": 123,
        "costDollars": 123,
        "pricePerMinuteCents": 123,
        "currency": "<string>",
        "billedAt": "2023-11-07T05:31:56Z",
        "note": "<string>"
      }
    }
  ],
  "pagination": {
    "pageSize": 123,
    "total": 123,
    "next": "<string>",
    "previous": "<string>"
  }
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Query Parameters

pageSize · integer · default: 50

Number of results per page (1-100)

Required range: 1 <= x <= 100

cursor · string

Pagination cursor from previous response (use value from pagination.next or pagination.previous)

status · string

Filter by call status (e.g., "ended", "agent_hangup")

startDate · string<date-time>

Filter calls from this date (ISO 8601 format)

endDate · string<date-time>

Filter calls until this date (ISO 8601 format)

Response

200 - application/json

Successful response

data · object[]

Show child attributes

pagination · object

Cursor-based pagination response (used by Call Logs endpoint)

Show child attributes