Skip to main content
POST
/
v1
/
calls
/
active
/
transfer
Transfer Active Call
curl --request POST \
  --url https://api.bland.ai/v1/calls/active/transfer \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "call_id": "<string>",
  "transfer_number": "<string>"
}
'
{
  "data": {
    "message": "Call 29f01d00-5197-4b83-bc0f-161e14533a78 transferred to +12223334444 successfully"
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Transfers an active call to a different phone number while the call is in progress. The current call leg is replaced with a <Dial> to the new number, no announcement is played to either party. Only calls in queue_status: "started" are eligible. Once transferred, the call record’s transferred_to field is updated so the new number appears in call details.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body Parameters

​
call_id
string
required
ID of the active call to transfer. Must currently be in progress.
​
transfer_number
string
required
Destination phone number in E.164 format (for example +12223334444). Parsed against the US region by default, so 10-digit US numbers also work.

​
Response

​
data.message
string
Confirmation message including the call_id and the destination number.
​
errors
null | array
null on success.
{
  "data": {
    "message": "Call 29f01d00-5197-4b83-bc0f-161e14533a78 transferred to +12223334444 successfully"
  },
  "errors": null
}
Docs for agents: llms.txt