Home/Documentation/API references/SIM Swap

Identity Live SS

SIM Swap

Check whether the SIM tied to a phone number has been swapped recently — one of the strongest signals of account-takeover fraud.

View full API reference →

Benefits

A SIM swap moves a phone number onto a new SIM card. It's a routine operation when someone loses a phone — and a favourite tool of fraudsters, who hijack a victim's number to intercept SMS codes and seize accounts. SIM Swap tells you whether a number's SIM has changed within a recent window, so you can step up checks, delay risky actions, or block SMS-based recovery exactly when a number can't be trusted.

How it works

You ask the operator a focused question about a number's SIM history. No SMS is sent and the end user sees nothing.

  • Your backend calls SIM Swap with the phone number and a time window.
  • The operator reports whether the SIM changed within that window — or returns the date of the last change.
  • You feed that signal into your risk logic before trusting the number.

Variants

  • Check — ask whether the SIM was swapped within a given period. Returns a true / false result.
  • Retrieve date — return the timestamp of the most recent SIM change, so you can apply your own thresholds.

Use cases

  • Account-takeover prevention — block or step up logins and transfers when a recent swap suggests the number may be hijacked.
  • SMS-OTP hardening — suppress SMS codes to numbers swapped within your risk window, defeating the classic SIM-swap interception attack.
  • Payment & transfer checks — gate high-value actions behind a clean SIM-swap result.
  • Layered fraud signals — combine with Number Verification for a fuller picture of whether a number can be trusted.

Quick start

With an access token (see OAuth2 with Konera), check a sandbox number against a time window:

curl -X POST https://api.pxg.konera.com/camara/sim-swap/v2/check \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"phoneNumber":"+14155550123","maxAge":240}'

Successful response:

{ "swapped": false }