Get Phone Number

Authorizations

Authorization

string

header

required

Retrieve your key from Dashboard.

Path Parameters

id

string

required

Response

200 - application/json

createdAt

string

required

This is the ISO 8601 date-time string of when the phone number was created.

id

string

required

This is the unique identifier for the phone number.

number

string

required

These are the digits of the phone number.

orgId

string

required

This is the unique identifier for the org that this phone number belongs to.

updatedAt

string

required

This is the ISO 8601 date-time string of when the phone number was last updated.

assistantId

string | null

This is the assistant that will be used for incoming calls to this phone number.

If this is not set, then the phone number will not handle incoming calls.

credentialId

string

This is the credential that will be used to handle this phone number.

This is for numbers not bought on Vapi.

name

string

This is the name of the phone number. This is just for your own reference.

Maximum length: 40

serverUrl

string

This is the server URL that will be used to handle this phone number.

All requests will be sent with the call object among other things relevant to that message. You can find more details in the Server URL documentation.

This overrides the serverUrl set on the org. Order of precedence: function.serverUrl > assistant.serverUrl > phoneNumber.serverUrl > org.serverUrl.

serverUrlSecret

string

This is the secret you can set that Vapi will send with every request to your server. Will be sent as a header called x-vapi-secret.

Same precendence logic as serverUrl.

stripeSubscriptionCurrentPeriodStart

string

This is the subscription's current period start.

stripeSubscriptionId

string

This is the subscription for the phone number.

stripeSubscriptionStatus

string

This is the subscription's status.

twilioAccountSid

string

This is the Twilio Account SID for the phone number.

This is for numbers not bought on Vapi.

twilioAuthToken

string

This is the Twilio Auth Token for the phone number.

This is for numbers not bought on Vapi.