Device Swap Retrieve v0.1

post https://{host}/device-swap/v0.1/retrieve-date

Get timestamp of last device swap for a mobile user account provided with phone number.

Check the Authorization guide on how to get an OAuth2 token, with the following scope:

dpv:FraudPreventionAndDetection#device-swap

Create an app on our Sandbox to get credentials and retrieve tokens so you can perform API calls to our operators' production environments, or use the following convenience token to test in mock mode:

mock_sandbox_access_token

You can explore our Device Swap sample code for additional guidance on using this API.

Responses

`"code": "INVALID_TOKEN_CONTEXT","message": "Phone number cannot be deducted from access token context."`)

`"code": "NOT_SUPPORTED","message": "Service not supported for this phoneNumber"`)
The phone number is not included in the request and the phone number information cannot be derived from the 3-legged access token. (`"code": "UNIDENTIFIABLE_PHONE_NUMBER","message": "The phone number is not included in the request and the phone number information cannot be derived from the 3-legged access token"`)

Language

Credentials

OAuth2

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://sandbox.opengateway.telefonica.com/apigateway/device-swap/v0.1/retrieve-date \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
 
1
{
2
  "latestDeviceChange": "2023-07-03T14:27:08.312+02:00"
3
}

200Contains information about Device swap change

400Bad Request

401Unauthorized

403Forbidden In addition to regular scenario of PERMISSION_DENIED, other scenarios may exist: Phone number cannot be deducted from access token context. ("code": "INVALID_TOKEN_CONTEXT","message": "Phone number cannot be deducted from access token context.")

404Not found

500Internal Server Error

503Service Unavailable

504Gateway Timeout

`"code": "INVALID_TOKEN_CONTEXT","message": "Phone number cannot be deducted from access token context."`)