Skip to main content
Live
  • Identity
Available in
  • UK

Tenure (CAMARA)

0.2

Tenure enables you to verify how long someone has been a customer (subscriber) on the Vodafone mobile network. You can use this information to spot potential fraudsters, and check whether someone has a track record of paying their monthly mobile bills. This can help build a level of trust for the customer associated with that number.

This API follows the CAMARA specification.

Try it out

Select the correct MNO for the mobile number

You must use a discovery service to determine which Mobile Network Operator's (MNO's) API you should use for each individual mobile number (MSISDN). This ensures API requests are efficiently directed to the correct MNO. This service is not provided by Vodafone.

A Three-legged OAuth Flow

Tenure (CAMARA) uses a three-legged OAuth flow. A three-legged OAuth process involves three parties: the end-user (or resource owner), the client (the third-party application), and the server (or authorization server):

  1. Get an authorization code
  2. Exchange the authorization code for an access token
  3. Call the Tenure resource API

For more information on OAuth, see OAuth 2.0 RFC 6749, section 4.1 (external website).

MSISDNs For The Sandbox Environment

In the Vodafone API Sandbox, specific Mobile Station International Subscriber Directory Numbers (MSISDNs) are provided to test various scenarios across different APIs. Each MSISDN is designed to simulate a particular condition or response, allowing developers to test their applications comprehensively.

  • When using these MSISDNs, ensure your application correctly interprets and handles each Response, providing appropriate responses or actions based on the simulated conditions.
  • These test numbers are designed to help you validate your application's robustness and reliability when interacting with Vodafone's APIs under different conditions.

By thoroughly testing with these MSISDNs, you can ensure that your application behaves as expected across a wide range of real-world scenarios, leading to a more reliable and user-friendly experience.

MSISDN Response Description
447772000001 TRUE Subscriber's tenure meets the required criteria.
447772000002 FALSE The subscriber's tenure does not meet the required criteria.
447772000004
447772000006
Unknown User The MSISDN does not correspond to any subscriber.

Vodafone Developer Portal

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