Nexmo's Account management API allows you to get your current balance, top-up your account, get pricing, buy numbers, cancel numbers, update numbers and show inbound numbers associated with your account.
To use these Choreos:
You'll need a Nexmo account, which you can create here.
Retrieve your Nexmo API Key and API Secret. You can find your Nexmo API Key and Secret in the API Settings menu on the top right of the Nexmo dashboard.
Make sure that your Nexmo number is configured correctly. When making calls with Nexmo, your number must be Voice-enabled. When sending SMS messages, it should be SMS-enabled. Your Nexmo number can be found by going to the Numbers tab in your Nexmo account.
Note: Nexmo free trial accounts can only send messages or make calls to registered phone numbers. Your registered Test Phone Number can be found here.