masstack

V1
API Overview Resources Schemas

Check SIM swap

Parameters

Name In Type Required Description
org_id path string true ‘none’
body body SimSwapCreateCheckSimSwap true Create a check SIM swap request for a phone number.

Request body - instance of SimSwapCreateCheckSimSwap

1
2
3
4

{
  "phoneNumber": "+346661113334",
  "maxAge": 240
}
Name Type Required Description
phoneNumber SimSwapPhoneNumber false A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ‘+’.
maxAge integer(int32) false Period in hours to be checked for SIM swap.

Request example

1
2
3
4
5
6
7
8
9


curl -X POST https://opengateway.masstack.com/v1/orgs/{org_id}/sim-swap/check \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'phoneNumber': '+346661113334',
  'maxAge': 240
}"

Responses

Code Meaning Description Schema
200 OK Returns whether a SIM swap has been performed during a past period SimSwapCheckSimSwapInfo
400 Bad Request Bad Request SimSwapErrorInfo
401 Unauthorized Unauthorized SimSwapErrorInfo
403 Forbidden Forbidden SimSwapErrorInfo
404 Not Found Not found SimSwapErrorInfo
422 Unprocessable Entity Unprocessable Content SimSwapErrorInfo
500 Internal Server Error Internal Server Error SimSwapErrorInfo
503 Service Unavailable Service Unavailable SimSwapErrorInfo
504 Gateway Time-out Gateway Timeout SimSwapErrorInfo

Endpoints

Validate consents

    Phone number verify

      Retrieve SIM swap date

        Check SIM swap