Skip to main content
POST
Carrier Age Gate
Asks the subscriber’s mobile carrier whether the account holder of a phone number is over the legal age threshold and returns synchronously. The threshold is set by the carrier and is 18 on all current routes. The actual age is never disclosed.
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.

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.age_gate, 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 Carrier Age Gate step, no second charge is taken because the passive step billed at session creation.