Find Available Numbers request.
Purchasing numbers is achieved by simply sending us the numbers you want, and the property to associate them with.
POST
/v2/Properties/[PropertySid]/Numbers
Parameter | Type | Description |
---|---|---|
PropertySid | string | Property to associate numbers with. |
Parameter | Type | Description |
---|---|---|
Number (E.164 Format) | string | The phone number you wish to add to your property. |
AddressSid (Optional) | string | Specify a specific address to assign to this number. If omitted and address is required, we will automatically assign the first suitable address that is registered on your property. The number will be reserved if no suitable address has been supplied. |
Our service will respond to every request for data with JSON formatted data. Requests to purchase numbers will return the number that was added to your property as confirmation.
Parameter | Type | Description |
---|---|---|
Number | string | The number requested to be added to your property. |
Status | string | Current status of the number. May be: Active: The number was added to your property and registered with an address. Pending: The number was added however no address matched for registration. |
For error codes and messages, please refer to the REST API Error Codes page.