Buy a number

To make and receive calls with the Voice API, and to receive messages using the SMS API, you need to buy a number to use with the API.

You can purchase numbers using the Dashboard in the Your Numbers  section, or programatically.

Search for a number

curl "https://rest.nexmo.com/number/search/API_KEY/API_SECRET/COUNTRY?pattern={pattern}&search_pattern={search_pattern}&features={features}&index={index}&size={size}"

Buy a number

curl -X POST "https://rest.nexmo.com/number/buy/API_KEY/API_SECRET/COUNTRY/MSISDN"