> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Age Verification

> Check people's ages from public evidence and decide what to do with each result.

This guide runs a batch of age verifications and sorts each person into pass, fail or manual review based on the evidence. For the request and response fields, see [Age Verification](https://docs.sixtyfour.ai/api-reference/endpoint/age-verification.md).

## Try it in the dashboard

Open [Age Verification in the API Playground](https://app.sixtyfour.ai/playground/verify-age), enter what you know about the person under Subject, and run it. The playground runs the same Job as the API and shows the date of birth, age, evidence and sources.

## Verify a batch and gate on confidence

Each verification takes a few minutes, so start them all, then poll. This script checks whether each person is at least 18 and sends anything uncertain to a human.

```python theme={null}
import time
import requests

BASE_URL = "https://api.sixtyfour.ai"
headers = {"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"}

MIN_AGE = 18
MIN_CONFIDENCE = 80  # 0-100; raise it for legal or compliance decisions

people = [
    {"name": "Jane Doe", "company": "Acme Corp", "linkedin": "https://www.linkedin.com/in/janedoe"},
    {"name": "John Smith", "location": "Austin, TX", "email": "john@example.com"},
]

job_ids = []
for person in people:
    start = requests.post(
        f"{BASE_URL}/v1/people/age-verification",
        headers=headers,
        json={"person": person, "wait_seconds": 0},
    )
    start.raise_for_status()
    job_ids.append(start.json()["job_id"])

pending = dict(zip(job_ids, people))
while pending:
    for job_id, person in list(pending.items()):
        response = requests.get(f"{BASE_URL}/v1/jobs/{job_id}", headers=headers)
        if response.status_code in (429, 503):
            time.sleep(float(response.headers.get("Retry-After", 15)))
            continue
        response.raise_for_status()
        job = response.json()
        if job["status"] in ("queued", "running"):
            continue
        del pending[job_id]

        if job["status"] != "succeeded":
            print(person["name"], "review", f"job {job['status']}")
            continue

        result = job["result"]
        age = result["age"]
        if age["value"] is None or age["confidence"] < MIN_CONFIDENCE:
            decision = "review"
        elif age["value"] >= MIN_AGE:
            decision = "pass"
        else:
            decision = "fail"
        print(person["name"], decision, age["value"], result["sources"])
    if pending:
        time.sleep(15)
```

## Reading the result

* The result is in the finished Job's `result`.
* Gate on `age.confidence` or `date_of_birth.confidence`, not on whether a value is present. Both are 0–100.
* A `null` date component means no source established it. A known birth year with an unknown day and month still pins the age to within a year.
* `age.value` can be an estimate when no date of birth was found. Its confidence reflects that.
* Keep `evidence` and `sources` with any decision you act on, so a reviewer can check them.

## Getting better matches

* Send every identifier you have in `person`: a company, location, email or LinkedIn URL along with the name.
* From an MCP client, use the `sixtyfour_verify_age_start` and `sixtyfour_verify_age_status` tools in the [MCP server](https://docs.sixtyfour.ai/developer-tools/mcp-setup.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.