Overview
Additional Information
Overview
Additional Information
Overview
Additional Information
Overview
Additional Information
Number Recycle
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.
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 URL | https://api-sandbox.vf-dmp.engineering.vodafone.com |
Live URL | https://eu3.api.vodafone.com |
Version history | Release date | Status | Description |
|---|---|---|---|
1.1.1 | September 2023 | Live | This API helps determine if a number has been recycled recently. There is no GSMA standard for this API currently. |
Endpoints
Method | Name | Endpoint |
|---|---|---|
GET | Premium Info | /mobileconnect/premiuminfo/v1 |
GET | Ping | /mobileconnect/premiuminfo/v1/ping |
GET | Status | /mobileconnect/premiuminfo/v1/status |
How it works
The Service Provider sends a request to the Number Recycle API, requesting whether a mobile number has been recycled.
The API performs a check against Vodafone's records.
Vodafone responds with the date of the last time the mobile number was recycled (if available). If no associated date is available, the attribute
reusereturnsfalse. Otherwise, it responds withreuse trueand theis_recycleddate stamp attribute is included.
Note:
Any mobile number 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 link below:
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