Tonedocs
API referenceCalls

Fetch the recording of the part with a person

After the agent handed the call to a person: the recording of that part of the call, as audio/wav (stereo, the caller on the left channel and the person on the right) or audio/mpeg (the carrier's own two-channel recording). Not enveloped. Absent when the agent's transfer setting has recording off, or when nobody took the call.

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

GET
/v1/calls/{id}/transfers/{transferId}/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.

transferId*string

The transfer's id.

Response Body

application/json

application/json

application/json

application/json

application/json

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