Skip to main content
POST
Phone Trust
Asks the subscriber’s mobile carrier for account-takeover signals on a phone number: a recent SIM swap and active unconditional call forwarding. Returns synchronously with a tripped verdict for the requested sensitivity. The check is passive. No SMS is sent to the subscriber, and the check never blocks anything on its own. Use tripped in your own flow, for example to require a step-up before a high-value action.
Carrier coverage varies by country. Where the carrier route is not live, signals come back as NO_DATA and the check never trips. UK numbers return live data today; US and Canadian numbers return NO_DATA.

Request

Headers

Body parameters

* Required unless sessionId is given, in which case it defaults to the session applicant’s phone.

Sensitivity

NO_DATA on a signal never trips the check.

Example request

Response

200 — Success

Error responses

Attaching to a session

By default each call is filed as a completed silent-screening session for audit and billed on success. Pass sessionId to attach the result to one of your existing verification sessions instead:
  • The result is written to that session’s analysis_data.phone_checks.trust, visible on Retrieve Session and in the console’s Carrier Intelligence tab.
  • phone may be omitted; it defaults to the session applicant’s phone.
  • A repeat call overwrites the previous result.
  • If the session’s workflow already contains the Phone Trust Check step, no second charge is taken because the passive step billed at session creation.