v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Conversations

List call records (minimal)

Returns a paginated, lightweight list of voice-agent call records for a project. Each row carries only the fields needed for dashboard timelines (id, createdAt, status, agent, duration, channel, phone numbers). Filter by voice agent, one-or-many statuses, and a UTC time range on createdAt.

Timestamps are UTC epoch milliseconds. Convert the user's local window to UTC on the client before calling.

get/v1/voice-agents/conversations/minimal-list

Query parameters

voiceAgentIdstring uuid

Example:849e77c6-5cb3-479a-a985-7fab630e2c78

Restrict results to a single voice agent.

statusstring[]

One or many JobStatus values. Repeat the parameter for multiple values (e.g. ?status=COMPLETED&status=FAILED).

[
  "COMPLETED",
  "FAILED"
]

startTimeinteger

Example:1747699200000

Inclusive lower bound on createdAt, as UTC epoch milliseconds.

endTimeinteger

Example:1747785600000

Inclusive upper bound on createdAt, as UTC epoch milliseconds. Must be greater than or equal to startTime when both are provided.

pageinteger

Example:1

1-indexed page number.

perPageinteger

Example:100

Number of records per page. Hard-capped at 200.

Response

Successful response

successboolean

messagestring

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "total": 137,
    "filtered": 2,
    "calls": [
      {
        "id": "e01b0877-1849-49f5-b4c2-d789fe603ec8",
        "createdAt": "2025-11-29T13:24:13.221Z",
        "status": "COMPLETED",
        "voiceAgentId": "1df8a0c5-d1c8-44bb-848f-8accf58f32e2",
        "agentName": "Support Agent",
        "duration": 35,
        "channelType": "Telephone",
        "callParams": {
          "machineNumber": "+16592225145",
          "userNumber": "+201095987769"
        }
      }
    ]
  }
}