{ "phoneNumbers": [ { "id": "<string>", "sms": "<StablePhoneNumberTarget>", "name": "<string>", "value": "<string>", "voice": "<StablePhoneNumberTarget>", "provider": "<PhoneNumberProvider>", "workspaceID": "<string>", "providerResourceID": "<string>", "createdAt": "2026-09-10T00:00:00.000Z", "updatedAt": "2026-09-10T00:00:00.000Z" } ] }

Authorizations

Authorization

string

header

required

Voiceflow bearer token

Query Parameters

projectID

string

List only the numbers assigned to this project, for either target. Mutually exclusive with workspaceID.

workspaceID

string

List every number the workspace holds, assigned or not. Mutually exclusive with projectID.

Response

200 - application/json

Returns the phone numbers, each with its name, value, provider, and the voice and sms targets that name the project, environment, and version it is assigned to (null when a side is unassigned).

phoneNumbers

object[]

required

The matching phone numbers, each with the project, environment and version its voice and sms sides reach.

Show child attributes

string

required

The ID of the phone number, used to assign, update and delete it. Not the number itself.

sms

object

required

Where incoming SMS go, or null when nothing handles SMS on this number.

Show child attributes

version

enum<string>

required

Which version of the environment answers: published, the one serving live traffic, or draft, the working copy. Null when no environment is pinned.

Available options: draft, published

projectID

string

required

The ID of the project this side of the number reaches.

environmentAlias

string

required

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.

name

string

required

The display name of the number within the workspace. Callers never see it.

value

string

required

The number itself, in E.164 (e.g. +14155552671).

voice

object

required

Where incoming calls go, or null when nothing handles calls on this number.

Show child attributes

version

enum<string>

required

Which version of the environment answers: published, the one serving live traffic, or draft, the working copy. Null when no environment is pinned.

Available options: draft, published

projectID

string

required

The ID of the project this side of the number reaches.

environmentAlias

string

required

provider

enum<string>

required

Who the number is held with. voiceflow-telnyx is a number bought through Voiceflow; the rest are numbers connected from your own carrier account. Fixed at creation.

Available options: twilio, vonage, telnyx, voiceflow-telnyx, voiceflow-sip, byo-sip

Show child attributes

workspaceID

string

required

The ID of the workspace the number belongs to.

providerResourceID

string

required

The number's ID with the provider, for reconciling against it.

createdAt

string

required

updatedAt

string

required

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks

List phone numbers

Authorizations

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks