Numbers at CALLR

This article addresses issues regarding number handling at CALLR. For more generic questions about phone numbers, please read our dedicated article:
👉 Number types overview

You can check numbers availability and by them directly from your Console or using our API. This article will walk you through both methods.

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.

If you use the CALLR console, you'll get a quote corresponding to the numbers you asked for before the purchase is finalized.

Number Purchase Parameters

Number Type

We offer both local (geographic) mobile (non-geographic) numbers in most countries we serve. You can pick your desired number type during the purchasing process.

Class: 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)

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.

Buying numbers (DIDs) on CALLR

You can buy, manage and assign your phone numbers directly from the Numbers page of your console.


Buying numbers (DIDs) with our API

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.

To buy DIDs in countries that are not part of the list returned by the did/areacode.countries method, please contact our support team. 

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.

Buying numbers with our API

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).

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.

Was this article helpful?
6 out of 9 found this helpful



Please sign in to leave a comment.