Check SIM Swap | Pinnacle

Check whether a phone number’s SIM was changed during a recent lookback window. Use this to flag account takeover risk before sign-in, password reset, payment, or other sensitive actions.

Limited availability. Contact founders@pinnacle.sh to request access.

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

phoneNumberstringRequiredformat: "^\+[1-9]\d{9,14}$"

Phone number in E.164 format, including country code.

periodHoursintegerOptional1-2400Defaults to 240

Lookback window, in hours, for detecting a recent SIM change. Must be from 1 to 2400. Defaults to 240.

Response

Returns SIM swap risk for the requested phone number.

requestIdstringformat: "^nar_[A-Za-z0-9]{16}$"

Unique Pinnacle ID for a Network API request.

statusenum

Availability of the carrier-backed insight.

Allowed values:

simSwappedboolean or null

Whether the SIM changed during the requested window. Null means the carrier insight was unavailable, unsupported, or failed.

latestSimSwapAtstring or nullformat: "date-time"

Timestamp of the latest SIM change in the requested window, when the carrier provides it.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error