SIM Swap Check

SIM Swap Check

2.1.0OAS 3.0

The SIM swap check API provides an endpoint to check if a SIM swap occurred within a given period.

API Base URL
  • Server 1:https://api2.uat.konera.com

    Kong Gateway URL

Security
apiKey (apiKey)

API key authentication header.

jwtToken (apiKey)

JWT token header; the gateway forwards it as Authorization: Bearer .

Check SIM swap

Check if SIM swap has been performed during a past period. Authentication: provide either jwt_token header (preferred) or api_key header.

post
https://api2.uat.konera.com/camara/sim-swap/check

Headers

x-correlatorstring

Correlation id for the different services

Match pattern:^[a-zA-Z0-9-_:;./<>{}]{0,256}$

Example:b4333c46-49c0-4f62-80d7-f0ef930f1c46

x-phone-numberstring

E.164 digits without ‘+’. If not provided, include “phoneNumber” in the request body.

Example:17147684731

Body

application/json

Create a check SIM swap request for a phone number.

CreateCheckSimSwap

phoneNumberstring

International E.164 format, prefixed with ‘+’.

Match pattern:^\+[1-9][0-9]{4,14}$

Example:+346661113334

maxAgeinteger(int32)

Period in hours to be checked for SIM swap.

Default:240

>= 1<= 2400

Example:240

Response

application/json

Returns whether a SIM swap has been performed during a past period

CheckSimSwapInfo

swappedbooleanrequired

Indicates whether the SIM card has been swapped during the provided max age period.

post/camara/sim-swap/check

Body

{
  "maxAge": 120
}
{ "maxAge": 120 }
 
curl --request POST \
  --url https://api2.uat.konera.com/camara/sim-swap/check \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'x-correlator: b4333c46-49c0-4f62-80d7-f0ef930f1c46' \
  --header 'x-phone-number: 17147684731' \
  --data '{
  "maxAge": 120
}'
application/json
{
  "swapped": false
}

XCorrelator

string

Match pattern:^[a-zA-Z0-9-_:;./<>{}]{0,256}$

Example
"b4333c46-49c0-4f62-80d7-f0ef930f1c46"