Tonedocs
API referenceCalls

List the transfer attempts on a call

Every attempt the agent made to hand this call to a person, oldest first. A call makes at most two. Empty when the agent never tried.

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

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

application/json

curl -X GET "https://example.com/v1/calls/string/transfers"
{  "data": [    {      "acceptedAt": null,      "answeredAt": "2026-10-13T10:01:41Z",      "attempt": 1,      "bridgedAt": "2026-10-13T10:01:52Z",      "brief": "Transfer from Acme's digital assistant, about a complaint. This call is recorded. Press 1 to take the call.",      "destination": {        "label": "Delivery team"      },      "endedAt": "2026-10-13T10:05:12Z",      "hasRecording": true,      "hasReturnRecording": false,      "humanSeconds": 200,      "id": "5b2c1e3d-9a4f-4e6b-8c7d-1f2e3a4b5c6d",      "mode": "screened",      "outcome": null,      "reason": "out_of_scope",      "requestedAt": "2026-10-13T10:01:30Z",      "status": "bridged",      "trigger": "model"    }  ]}
Was this page helpful?