Skip to main content
Live
  • Identity
Available in
  • UK

Number Recycle

1.1.1

Use this API to find out when a mobile number has been deactivated and recycled. Number Recycle helps reduce account lockouts and SMS notifications going to the wrong user.

This API follows a proprietary Vodafone specification.

Try it out

Live
  • Identity
Available in
  • UK

Number Recycle

1.1.1

Use this API to find out when a mobile number has been deactivated and recycled. Number Recycle helps reduce account lockouts and SMS notifications going to the wrong user.

This API follows a proprietary Vodafone specification.

Try it out

Image
Lightbulb icon
It can be used for
 
  • Reducing fraud
  • Verifying authenticity of users
  • Data cleanup
  • Identifying if a number has changed ownership

API Information

Version v1.1.1
Protocol HTTPS
Sandbox https://api-sandbox.vf-dmp.engineering.vodafone.com
URL https://eu3.api.vodafone.com
Version history 1.1.1
Release date September 2023
Status Live
Description This API helps determine if a Number has been recycled recently. There is no GSMA standard for this API currently.

How it works

  1. The Service Provider sends a request to the Number Recycle API, requesting whether a mobile number has been recycled.
  2. The API performs a check against the Vodafone mobile number.
  3. Vodafone responds with the date of the last time the mobile number was recycled (if available). If no associated date is available, the attribute "reuse" = false. Otherwise, it responds with "reuse" = true and the is_recycled date stamp attribute is included.
Note

Any mobile number originating from Vodafone that was recycled before 19th August 2020 will not be shown as having been recycled.

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