Skip to main content
Live
  • Identity
Available in
  • UK

Tenure

1.1.1

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 GSMA Mobile Connect specification.

Try it out

Live
  • Identity
Available in
  • UK

Tenure

1.1.1

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 GSMA Mobile Connect specification.

Try it out

Image
Lightbulb icon
It can be used for
  • Checking subscription tenure date
  • Spotting potential fraudsters
  • Tracking monthly bill payments
  • Building a level of trust with for customer

     

API Information

Verision v1.1.1
Protocol HTTPS
Sandbox URL https://api-sandbox.vf-dmp.engineering.vodafone.com
Live URL https://eu3.api.vodafone.com
Version history 1.1.1
Release date June 2024
Status Live
Description This API indicates the duration of a subscriber being known to the Mobile Operator. Tenure extends the ATP specification for Mobile Connect.

How it works

  1. The Service Provider sends a request to the Tenure API, containing the customer's MSISDN and a start date.
  2. The API performs a check against the Vodafone mobile number.
  3. Vodafone responds. If the tenure date is before the input date in the API request, it returns a 'true' response. If the tenure date is after the input date in the API request, it returns a 'false' response. 
  4. The Service Provider can allow or deny the user's actions based on the tenure information provided by the API.

Run in Postman

To begin using the Vodafone workspace in Postman, please follow the steps below to create a set of credentials that can be used with our sandbox collections:

  • Register an account on https://developer.vodafone.com and create a sandbox app for the APIs that you are interested in.
  • Use the Client Key and Secret from your sandbox app to populate the relating variables in the "Sandbox Credentials" environment group in Postman.
  • Call the token endpoint to create a bearer token that is used in the API resource endpoint. Your client credentials will be taken from the environment variables and used in a basic OAuth flow.
  • You need to call the token end-point for each API as the API scope is held in the request body of the token call.
  • The last bearer token and trace ID will be stored in collection variables associated with the API solution that you have chosen.
  • You can use these collections as read-only or create a fork into your own personal workspace to edit the details.

You can access all of Vodafone's sandbox APIs in our Postman workspace by clicking the button below:

Run in Postman Button

What is Postman?

Postman is a popular development and testing tool that is widely used across the API developer community. It offers an easy to use interface for making HTTP requests, testing API responses and collaborating with team members. For more details, see postman.com

Vodafone Developer Portal

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