Live
  • Identity
Available in
  • UK

Active Subscriber

1.1.1

This API checks if a mobile device is currently connected to the network and reachable. For example, if the number is switched off or unreachable, the API should return 'false'.

This API follows a proprietary Vodafone specification.

Try it out

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.

FAQs

Q1. What does a 200 response mean?

A 200 response indicates that the request was successfully processed. The body of the response will return one of the following values:

  • True - The device is connected to the Vodafone network and is reachable.
  • False- The device is switched off or currently unreachable.

Q2. What happens if the number is not a Vodafone number?

If the MSISDN does not belong to Vodafone, the API will return a 400 Not Found.

Q3. Why might a reachable Vodafone number still return false?

A false does not always mean the number is invalid - it only means the device cannot currently be reached. This may occur if:

  • The device is powered off
  • The device is in airplane mode or out of coverage
  • The subscriber is temporarily not attached to the network
X Facebook

Vodafone Developer Portal

Discover, try, and purchase our APIs to start building your own apps