Tone docs
API referenceCalls

Fetch a call's audio recording (WAV)

Streams the recording as audio/wav, in stereo: the caller on the left channel, the agent on the right. Not enveloped, and often several megabytes. Absent when recording is off for the number, or when the call never connected.

Requires the read scope. A key with less gets 403 insufficient_scope.

GET
/v1/calls/{id}/recording
AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The call's id.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/calls/string/recording"
Empty
Was this page helpful?