Purchase Numbers


The Fone Dynamics REST API allows you to purchase available numbers we currently have listed. Available numbers can be found using our Find Available Numbers request.


Purchasing numbers is achieved by simply sending us the numbers you want, and the property to associate them with.




URI Parameters

Parameter Type Description
PropertySid string Property to associate numbers with.

Resource Parameters

Parameter Type Description
(E.164 Format)
string The phone number you wish to add to your property.


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.


200 – OK

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.

400 – Error

For error codes and messages, please refer here.