THE LINUX FOUNDATION PROJECTS

Device Roaming Status

API Description
Use Cases
  • Fraud Prevention: A financial institution or other business can use the API to verify whether the customer’s mobile device is in the expected country. For example, online transactions originating from outside the customer’s home country may be fraudulent if the customer’s mobile device is not roaming. Similarly, it can be expected that the customer’s device will be roaming in a country where their bank card is currently being used for a transaction.
  • Content Restrictions: A streaming service uses the API to prevent users from watching content outside of licensed regions. For example, a user who is currently travelling in another country cannot watch content restricted to a different country.
  • Advertising: An advertiser uses the API to ensure that advertisements are only displayed in specific countries or regions. By verifying the roaming status of the device, the advertiser can ensure that the advert reaches the desired audience and is not shown to a user in an unauthorized area.

See also at GSMA:

Benefits
  • Real-time Roaming Status: Retrieve the roaming status of a device in real-time, including the country in which the device is roaming.
  • Regulatory Compliance: Ensure compliance with regulations for different regions and countries.
  • Fraud Prevention: The API can be used to detect and prevent fraudulent activities, such as when a device is located in an unexpected country, or to prevent transactions originating from unauthorised countries.
  • Customer Experience: Tailor the customer experience to the country in which they are currently working or travelling.

API Portfolio: Device Information

Sub Project Wiki: Device Status
(incl. how to meet the team)

API Wiki: Device Roaming Status

API Repository: Device Roaming Status

API Repository Status: Incubating

API Status: Stable

API Version(s) and Release Date(s):

  • v0.2.0 (16.03.2023)
  • v0.4.1 (21.04.2023)
  • v0.5.1 (10.04.2024)
  • v0.6.1 (05.11.2024), Fall24 meta-release
  • v1.0.0 (14.03.2025), Spring25 meta-release
  • v1.1.0 (16.09.2025), Fall25 meta-release

API availability: Information which APIs are available in which country and network, and how to get access can be found on the GSMA public launch status page.

Be part of a collaborative community driving the future of global Telco APIs.

Join Today