REST API: voice calls

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 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.