v2

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-051420.0 KB
NumbersV3HostedNumbersHostedNumberOrder

Host a phone number's capability on Twilio's platform.

post/v3/HostedNumbers/HostedNumberOrders

Response

Created

sidstring nullable

A 34 character string that uniquely identifies this HostedNumberOrder.

accountSidstring nullable

A 34 character string that uniquely identifies the account.

incomingPhoneNumberSidstring nullable

A 34 character string that uniquely identifies the IncomingPhoneNumber resource that represents the phone number being hosted.

addressSidstring nullable

A 34 character string that uniquely identifies the Address resource that represents the address of the owner of this phone number.

signingDocumentSidstring nullable

A 34 character string that uniquely identifies the Authorization Document the user needs to sign.

phoneNumberstring phone-number nullable

Phone number to be hosted. This must be in E.164 format, e.g., +16175551212

friendlyNamestring nullable

A 64 character string that is a human-readable text that describes this resource.

uniqueNamestring nullable

Provides a unique and addressable name to be assigned to this HostedNumberOrder, assigned by the developer, to be optionally used in addition to SID.

status'twilio-processing' | 'received' | 'pending-verification' | 'verified' | 'pending-loa' | 'carrier-processing' | 'testing' | 'completed' | 'failed' | 'action-required'
failureReasonstring nullable

A message that explains why a hosted_number_order went to status "action-required"

dateCreatedstring date-time nullable

The date this resource was created, given as GMT RFC 2822 format.

dateUpdatedstring date-time nullable

The date that this resource was updated, given as GMT RFC 2822 format.

verificationAttemptsinteger

The number of attempts made to verify ownership of the phone number that is being hosted.

emailstring nullable

Email of the owner of this phone number that is being hosted.

ccEmailsstring[] nullable

A list of emails that LOA document for this HostedNumberOrder will be carbon copied to.

urlstring uri nullable

The URL of this HostedNumberOrder.

verificationType'phone-call' | 'phone-bill'
verificationDocumentSidstring nullable

A 34 character string that uniquely identifies the Identity Document resource that represents the document for verifying ownership of the number to be hosted.

extensionstring nullable

A numerical extension to be used when making the ownership verification call.

callDelayinteger

A value between 0-30 specifying the number of seconds to delay initiating the ownership verification call.

verificationCodestring nullable

A verification code provided in the response for a user to enter when they pick up the phone call.

verificationCallSidsstring[] nullable

A list of 34 character strings that are unique identifiers for the calls placed as part of ownership verification.

All 1 operations