Skip to main content
POST
Phone Ownership
Asks the subscriber’s mobile carrier how well a name, and optionally an address and date of birth, matches the account holder on record for a phone number. Returns synchronously with the carrier’s match scores and an outcome against a strictness threshold. The subscriber record itself is never disclosed. Only the name score decides the outcome. Address and date-of-birth scores are returned for information.
Carrier coverage varies by country. Where the carrier route is not live the outcome is NO_DATA. 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. ** At least one of firstName or lastName is required unless sessionId is given, in which case the session applicant’s name is used.

Strictness

Example request

Response

200 — Success

Score meanings: -1 the carrier holds no data, 0 held but no match, 1–99 partial match, 100 exact match.

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.ownership, visible on Retrieve Session and in the console’s Carrier Intelligence tab.
  • phone, firstName and lastName may be omitted; they default to the session applicant.
  • A repeat call overwrites the previous result.
  • If the session’s workflow already contains the Phone Ownership Match step, no second charge is taken because the passive step billed at session creation.