Search
K

SIM Swap Check API

Overview

The SIM Swap Check API determines whether a SIM swap has occurred for a given phone number within a specified time window.

  • Version: 2.0.0
  • Base URL: https://api.pxg.konera.com/camara
  • Path: /sim-swap/v2/check
  • OpenAPI: sim-swap-check.openapi.json

Typical use cases

  • Payment authentication – Add a strong risk signal before authorizing card‑not‑present or wallet payments.
  • Account takeover protection – Detect recent SIM swaps when password resets or credential changes are requested.
  • KYC and onboarding – Treat very recent SIM swaps as higher risk during onboarding flows.

Security

  • OAuth2 Client Credentials
    • Token URL: https://auth.konera.com/oauth2/token
    • Scope: sim-swap.read – Read SIM swap signal

Headers

  • x-correlation-id (optional, string) – Correlation ID for request tracing.

Request

POST https://api.pxg.konera.com/camara/sim-swap/v2/check

Body schema: SimSwapCheckRequest

{
  "phoneNumber": "+14155550123",
  "maxAge": 2400
}
  • phoneNumber (string, required) – MSISDN in E.164 format.
  • maxAge (integer, required) – Maximum age (seconds) to look back for SIM swap events.

Responses

200 – SIM swap status returned

Body schema: SimSwapCheckResponse

{
  "simSwapped": false
}
  • simSwapped (boolean) – true if a SIM swap has occurred within the requested time window.

HTTP status codes

Standard Error schema with:

  • 200 OK – SIM swap status successfully evaluated.
  • 400 Bad Request – Invalid maxAge or phone number.
  • 401 Unauthorized – Invalid/missing token.
  • 403 Forbidden – Caller not permitted to access SIM swap data.
  • 429 Too Many Requests – Rate limit exceeded.
  • 500 Internal Server Error – Unexpected server error.