Skip to main content
POST
List Twilio Phone Numbers

Authorizations

Authorization
string
header
required

Specify the authorization token.

For more information, check out the Authorization Guide.

Body

The credentials of your own Twilio account, sent with each Twilio request: the Account SID with the Auth Token, or the Account SID with the SID of a Standard API Key and its secret. They are not saved as the Twilio integration of your account: listing the numbers does not store them, and an imported number keeps them only for its own calls.

accountSid
string
required

The Account SID of your Twilio account (starts with AC).

Minimum string length: 1
authToken
string
required

The Auth Token of your Twilio account, or the API Key Secret when apiKeySid is provided. The credentials must have full access: a Restricted API Key is rejected.

Minimum string length: 1
apiKeySid
string | null

Optional SID of a Standard API Key of your Twilio account (starts with SK). Leave it empty to authenticate with the Auth Token.

Response

The phone numbers of the Twilio account.

number
string | null

The phone number in E.164 format: the number to send to import it.

sid
string | null

The Twilio SID of the phone number, as shown in the Twilio console.

friendlyName
string | null

The friendly name of the phone number in Twilio, if any.

isVerifiedCallerId
boolean

Whether the number is a verified caller ID: a number hosted outside Twilio and only verified on it as a caller ID. Such a number is imported for outbound calls only.

phoneNumberId
string | null

The ID of the phone number in your account when this number is already imported. Omitted otherwise.