Skip to main content
POST
Purchase a number
Purchases the specified available number when additional regulatory information is not required in the request. Provide number in E.164 format, including the leading + (for example, +13346412481). A number without the leading + is invalid. The optional type field selects the service type. Its currently accepted values are fax and voice.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
number
string
required

Phone number to purchase in E.164 format, including the leading +.

Pattern: ^\+[1-9]\d{1,14}$
type
enum<string>

Optional service type for the purchased number.

Available options:
fax,
voice

Response

The number was purchased and provisioned to the authenticated account.

status
integer
required
message
string
required
data
object
required