Skip to main content

Use case

Confirm a person’s age for trust-and-safety, KYC, and due-diligence workflows where self-reported age isn’t enough. Age Verification researches public sources to establish a date of birth (or a grounded age estimate when an exact date isn’t available), and returns the evidence and sources behind the determination.

API Reference

See the full request/response schema and parameters in the API Reference.

Pricing

Age Verification runs at the same rate as the high tier of People Intelligence. See Credits & Pricing Guide for credit costs.
Unlike calling People Intelligence directly with tier: "high", Age Verification does not require high-tier access approval — it’s available to any paying org.

Errors

For error responses (400, 403, 404, etc.), see Handling Errors.

Start an age verification

Submit the person to verify. Returns a task_id for polling.

Example request

Save the task_id returned in the response — you’ll need it to poll for the result.
subject also accepts lead_info or input as aliases, so callers already integrated with People Intelligence can reuse the same request shape unchanged.

Get verification status

Poll for progress and results of a running or completed age verification.
task_id is the value returned by Start an age verification.

Status values

Understanding the response

Once completed, the response contains:
A null date-of-birth component means it was not established from concrete evidence — Age Verification never guesses a day, month, or year. age.value may still be populated as an estimate in that case.

Example usage