Numbers

API Docs by APIMATIC

Numbers
#

  • REST
  • Java

Numbers
#

Numbers
#

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.

Prerequisites
#

  • Your contact center must own at least one phone number.

Making requests
#

Authentication
#

The numbers API requires the base URL and the contact center API key.

Request parameters
#

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

Troubleshooting
#

The following issues are sometimes encountered:

Too many requests
#

If you see this error, "error": "API rate limit exceeded", reduce the number of API requests you send per second.

Unauthorized
#

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.