sim-swap

SIM Swap (0.4.0)

SIM Swap API provides the customer the ability to obtain information on any recent SIM pairing change related to the User's mobile account.

This API derives from the GSMA Mobile Connect Account Takeover Protection specification Mobile Connect Account Takeover Protection. For more about Mobile Connect, please see about Mobile Connect.

The API provides 2 operations:

POST retrieve-date : Provides timestamp of latest SIM swap
POST check: Checks if SIM swap has been performed during a past period (defined in the request with 'maxAge' attribute).

Product documentation at Camara

Download OpenAPI description

sim_swap.json

sim_swap.yaml

Overview

E-mail awsgsma@u.com.my

License Apache 2.0

Servers

Mock server

https://developers.opgw.u.com.my/_mock/sim-swap/sim_swap/

Sandbox server (uses test data)

https://api-sandbox.opgw.u.com.my/sim-swap-service/sim-swap/v0/

Retrieve SIM swap date

Operations

retrieveSimSwapDate

Request

Get timestamp of last MSISDN <-> IMSI pairing change for a mobile user account provided with MSIDN.

Bodyapplication/jsonrequired

Create a SIM swap date request for a MSISDN identifier.

phoneNumberstring(PhoneNumber)^\+?[0-9]{5,15}$required

Subscriber number in E.164 format (starting with country code). Optionally prefixed with '+'.

Example: "+60182222111"

curl -i -X POST \
  https://developers.opgw.u.com.my/_mock/sim-swap/sim_swap/retrieve-date \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "phoneNumber": "+60182222111"
  }'

Responses

Contains information about SIM swap change

Bodyapplication/json

latestSimChangestring(date-time)

Timestamp of latest SIM swap performed

Response

application/json

{
  "latestSimChange": "2019-08-24T14:15:22Z"
}

Check SIM swap