Countries with available numbers (DIDs)

Our API offers methods to get quotes on, reserve and buy DIDs. You can get the list of countries where the service is offered using the did/areacode.countries method (doc). It returns the list of available countries as well as their code, required by other methods to interact with DIDs.

Number types available in a given country

You can view the number types available in a country using the did/areacode.types method (doc). It returns the list of number types available in a certain country, given the country code as a parameter.

To view the area codes offered within a country, use the did/areacode.get_list method (doc). It returns all the region-specific numbers available, their id, name, and prefix given the country code and number type as parameters.

Gold and Classic numbers

"Gold" (as opposed to "Classic") phone numbers are numbers that are easy to remember because they are sequential, repetitive or both. Here are some examples:

(646) 345 6789 - sequential

(646) 286 4545 - repetitive

(646) 365 3650 - repetitive

(646) 555 7770 - repetitive (triple-triple)

Buying numbers (DIDs)

If you need to buy a number but are not comfortable using the API, feel free to contact the support team to process your order.

You must reserve numbers using the did/store.reserve method (doc) before being able to buy them. You will receive a reservation status object containing the price, the actual numbers you can buy and an order token. To proceed with your purchase order end effectively buy the desired numbers, use the did/store.buy_order method (doc).

Assignment modes

The assignment mode parameter corresponds to the attribution method of the desired numbers:

Sequential mode assigns numbers preferably following each other: for instance, if you buy three numbers you will get: (646) 982 0820, (646) 982 0821 and (646) 982 0822.

Random mode assigns numbers randomly.

Cost of a number

You can get number prices (as well as voice and SMS prices) on the pricing section of our website. With the country selector, you can get a summary of the prices for any country you need to contact.

To query the price of phone numbers with the API, use the did/store.get_quote method (doc). It returns the number(s) price in cents (0.01€) and the discount if relevant given the area code, the number class and amount as parameters.

Find out owned numbers (DIDs) using the API

The apps.get_dids method (doc) returns the list of DIDs assigned to your account. It takes a boolean as a parameter to return only the available DIDs (not already assigned to a voice app) if True.