Search
K
Device Swap

Device Swap

1.0.0OAS 3.0

CAMARA Device Swap API.
Provides a network signal indicating whether a given phone number
has recently been associated with a different device.

API Base URL
  • Server 1:/
Security
OAuth2ClientCredentials (oauth2)

Client Credentials OAuth Flow

Token URL: https://auth.example.com/oauth2/token

Scopes:

  • device-swap.read - Read device swap signal

Device Swap

Device swap detection APIs

Check last device swap event

post
/device-swap/v1/device-swap

Headers

x-correlation-idstring

Correlation ID for request tracing

Body

application/json

DeviceSwapRequest

phoneNumberstringrequired

MSISDN in E.164 format

Example:+919036499174

maxAgeSecondsinteger

Maximum acceptable age of swap information (seconds)

>= 0

Example:86400

Response

application/json

Device swap status retrieved successfully

DeviceSwapResponse

deviceSwapobjectrequired
Show Child Parameters
post/device-swap/v1/device-swap

Body

{ "phoneNumber": "+919036499174" }
application/json

DeviceSwapRequest

object
phoneNumberstringrequired

MSISDN in E.164 format

Example:+919036499174

maxAgeSecondsinteger

Maximum acceptable age of swap information (seconds)

>= 0

Example:86400

Example

DeviceSwapResponse

object
deviceSwapobjectrequired
Show Child Parameters
Example