Home/Documentation/API references/Device Roaming Status

Connectivity Live DSr

Device Roaming Status

Check whether a device is currently roaming — and which country it's roaming in — straight from the operator network.

View full API reference →

Benefits

Device Roaming Status reports whether a subscriber's device is connected to a visited network rather than its home network, and which country that network is in. Roaming state is a meaningful signal: it can corroborate a user's claimed travel, explain unusual transaction locations, or flag activity that doesn't fit the expected pattern — all without GPS or any action from the user.

How it works

You ask the operator about a number's current network attachment.

  • Your backend calls Device Roaming Status with the phone number.
  • The operator reports whether the device is roaming and, where available, the country code of the visited network.
  • You feed that into your logic — risk scoring, regional rules, or travel confirmation.

Use cases

  • Transaction risk scoring — corroborate or challenge a payment when the device is roaming far from the cardholder's usual region.
  • Travel-aware experiences — adapt content, pricing, or support routing when a user is abroad.
  • Fraud detection — flag impossible-travel patterns by combining roaming country with recent activity.
  • Compliance & regional rules — apply jurisdiction-specific behaviour based on where the device is attached.

Quick start

With an access token (see OAuth2 with Konera), query a sandbox number:

curl -X POST https://api.pxg.konera.com/camara/device-roaming-status/v1/retrieve \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"device":{"phoneNumber":"+14155550123"}}'

Successful response:

{ "roaming": true, "countryCode": 91, "countryName": ["IN"] }