Skip to main content
Live
  • Identity
Available in
  • Germany,
  • Greece,
  • Netherlands,
  • Spain,
  • UK

Sim Swap

1.1.1

Fraudsters can use social engineering techniques to get users to give them control of a mobile number. Sim Swap fraud is also known as Unauthorised Account Takeover.

This API follows the GSMA Mobile Connect 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.

Getting an access token

You need an access token in order to use this API.

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.

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 2017-12-31T14:59:59Z A SIM change was detected for the subscriber on this date.
447772000002 1/20/2024 A SIM change was detected for the subscriber on this date.
447772000004
447772000006
Unknown User The MSISDN does not correspond to any subscriber. Use these for error handling unknown users.

Vodafone Developer Portal

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