masstack

V1
API Overview Resources Schemas

Sim Swap

API operation related with sim swap.

Parameters

Name In Type Required Description
Authorization header string true Bearer ‘token’
body body CreateSimSwapDate true Create a SIM swap date request for a phone number.

Request body - instance of CreateSimSwapDate

1
2
3

{
  "phoneNumber": "+346661113334"
}
Name Type Required Description
phoneNumber PhoneNumber 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 ‘+’.

Request example

1
2
3
4
5
6
7
8
9


curl -X POST https://apimanager-opengateway.sta.k8s.masmovil.com/sim-swap/v1/retrieve-date \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: string" \
 --data-raw "{
  'phoneNumber': '+346661113334'
}"

Responses

Code Meaning Description Schema
200 OK Contains information about SIM swap change SimSwapInfo
400 Bad Request Problem with the client request ErrorInfo
401 Unauthorized Unauthorized ErrorInfo
403 Forbidden Forbidden ErrorInfo
404 Not Found Not found ErrorInfo
422 Unprocessable Entity Unprocessable Content ErrorInfo
500 Internal Server Error Server error ErrorInfo
503 Service Unavailable Service unavailable. Typically the server is down. ErrorInfo
504 Gateway Time-out Request time exceeded. If it happens repeatedly, consider reducing the request complexity ErrorInfo

Parameters

Name In Type Required Description
Authorization header string true Bearer ‘token’
body body CreateCheckSimSwap true Create a check SIM swap request for a phone number.

Request body - instance of CreateCheckSimSwap

1
2
3
4

{
  "phoneNumber": "+346661113334",
  "maxAge": 240
}
Name Type Required Description
phoneNumber PhoneNumber 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
10


curl -X POST https://apimanager-opengateway.sta.k8s.masmovil.com/sim-swap/v1/check \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: string" \
 --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 CheckSimSwapInfo
400 Bad Request Problem with the client request ErrorInfo
401 Unauthorized Unauthorized ErrorInfo
403 Forbidden Forbidden ErrorInfo
404 Not Found Not found ErrorInfo
422 Unprocessable Entity Unprocessable Content ErrorInfo
500 Internal Server Error Server error ErrorInfo
503 Service Unavailable Service unavailable. Typically the server is down. ErrorInfo
504 Gateway Time-out Request time exceeded. If it happens repeatedly, consider reducing the request complexity ErrorInfo

Endpoints

Phone number verify

    Sim Swap

      Device Swap

        KYC Match

          KYC Age Verification

            Consent Information

              Authentication

                Phone number share