REST API: voice calls
List voice call records and fetch call recording playback URLs.
Use GET /voice/calls to list voice calls handled by your agents, for reporting or for building your own call history view. Use GET /voice/calls/{id}/recording-url to fetch a playback URL for a specific call's recording.
The voiceProvider field is how the call was billed, not the name of one engine. It holds one of three values: a realtime engine id, such as gpt-realtime-1.5; the id of a voice-combination chain, such as deep-reasoning; or the literal combination:custom for a chain that no named chain matches. A call that ran a combination therefore reports a value that is not an engine id. Do not treat this field as an engine id, and do not build a fixed list of the values it can hold. The three models of a combination are not returned by this endpoint. See Configure voice calls for the providers.
The recording URL is short-lived. Fetch it just before you need to play or download the recording, not ahead of time, and request a fresh URL if enough time has passed that the previous one may have expired. Do not store the URL itself as a durable reference to the recording; store the call identifier and request a new URL when you need access again.
Call recordings can contain sensitive customer conversations. Restrict which of your own systems and users can call this endpoint, and apply the same handling standards to a fetched recording that you apply to any other customer voice data, including retention and deletion practices consistent with your organization's policies.
These endpoints are read-only. Configuring voice channels, phone numbers, and call handling remains a dashboard task.