The numbers API is part of Voiso's Number Management APIs. Use it to retrieve a list of the phone numbers owned by your contact center. Please refer to the detailed API endpoint specification here.
The numbers API requires the base URL and the contact center API key.
The numbers API uses the following parameters.
The Authorization: Bearer token
parameter is the contact center API key. It is used in the request header.
The page
parameter is the pagination offset. Read the Metadata in the initial response to determine how many pages of data are available.
With these parameters, you can make a simple request:
GET https://cluster1.voiso.com/api/numbers/v1/numbers?page=1
The following issues are sometimes encountered:
If you see this error, "error": "API rate limit exceeded"
, reduce the number of API requests you send per second.
The numbers API uses the contact center API key to validate the request. If you see this error, "error": "Invalid API key"
, check that you use the correct contact center API key. For more information about API keys, refer to Authentication.