Voiceflow bearer token
Get phone number
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/phone-number/<phoneNumberID> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/phone-number/<phoneNumberID>?workspaceID=<workspaceID>', {
method: 'GET',
headers: {
Authorization: 'Bearer <token>',
},
});
const data = await response.json();import requests
response = requests.get(
'https://realtime-api.voiceflow.com/v1/stable/phone-number/<phoneNumberID>?workspaceID=<workspaceID>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf phone-number get --phone-number-id <phoneNumberID> --workspace-id <workspaceID>{
"phoneNumber": {
"id": "<string>",
"sms": {
"version": "draft",
"projectID": "<string>",
"environmentAlias": "<string>"
},
"name": "<string>",
"value": "<string>",
"voice": {
"version": "draft",
"projectID": "<string>",
"environmentAlias": "<string>"
},
"provider": "twilio",
"workspaceID": "<string>",
"providerResourceID": "<string>",
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z"
}
}Get phone number
Returns one phone number with its provider and the targets each side answers as. The `phoneNumberID` is the ID Voiceflow gives the number, not the number itself.
GET
/v1/stable/phone-number/{phoneNumberID}
Get phone number
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/phone-number/<phoneNumberID> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/phone-number/<phoneNumberID>?workspaceID=<workspaceID>', {
method: 'GET',
headers: {
Authorization: 'Bearer <token>',
},
});
const data = await response.json();import requests
response = requests.get(
'https://realtime-api.voiceflow.com/v1/stable/phone-number/<phoneNumberID>?workspaceID=<workspaceID>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf phone-number get --phone-number-id <phoneNumberID> --workspace-id <workspaceID>{
"phoneNumber": {
"id": "<string>",
"sms": {
"version": "draft",
"projectID": "<string>",
"environmentAlias": "<string>"
},
"name": "<string>",
"value": "<string>",
"voice": {
"version": "draft",
"projectID": "<string>",
"environmentAlias": "<string>"
},
"provider": "twilio",
"workspaceID": "<string>",
"providerResourceID": "<string>",
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z"
}
}Authorizations
Response
200 - application/jsonReturns the phone number with its name, value, provider, and the voice and sms targets naming the project, environment, and version each side answers as.
Show child attributes
Where incoming SMS go, or null when nothing handles SMS on this number.
Show child attributes
The alias of the environment this side of the number reaches (e.g. main). Null in two cases: the number is assigned to the project with no environment pinned, or the environment it was pinned to has since been deleted — version is still whatever the pin asked for, so a null alias beside a non-null version is the second case.
Where incoming calls go, or null when nothing handles calls on this number.
Show child attributes
The alias of the environment this side of the number reaches (e.g. main). Null in two cases: the number is assigned to the project with no environment pinned, or the environment it was pinned to has since been deleted — version is still whatever the pin asked for, so a null alias beside a non-null version is the second case.
Was this page helpful?
Thanks for your feedback.