Getting an Access Token

You need an access token in order to use this API.

For example:

Authorization: Bearer alEw85xBVY83owVraNwNxzsfmpXu

The token is valid for 59 minutes and 59 seconds. It can be used for multiple requests.

The bearer tokens can only be used for a specific country. For example: If you generate a token for a UK mobile number, you cannot use it to query a German mobile number.

For more information on using Authorization Basic, see RFC 6749.

If the request is valid, the API returns an access_token, along with expiry and scope information.
This access token can then be used in one or more requests for as long as the token remains valid.

If the request is not valid, the APIs returns an error message.