> ## 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

> Establish a person's date of birth or age from public sources, with confidence scores, evidence and source URLs.

This page uses the original routes, which keep working. For new integrations, see [Age Verification](https://docs.sixtyfour.ai/api-reference/endpoint/age-verification.md).

For when and how to use Age Verification in a trust-and-safety or KYC flow, see the [Age Verification guide](https://docs.sixtyfour.ai/guides/age-verification.md).

## Endpoint

```http theme={null}
POST https://api.sixtyfour.ai/verify-age
GET  https://api.sixtyfour.ai/verify-age/{task_id}
```

## Request

`POST /verify-age` takes one field.

| Parameter | Type | Required | Description |
| - | - | - | - |
| `subject` | object | Yes | The person to verify: any identifiers you have, such as `name`, `company`, `linkedin`, `email`, `location`. Must not be empty. |

`lead_info` and `input` are aliases for `subject`. Other keys, including `struct`, `tier` and `webhook_url`, are ignored; poll for the result.

The response is the job handle:

```json theme={null}
{"task_id": "7f3c9a2e-1b4d-4e8a-9c6f-2d5e8b1a0c37", "status": "RUNNING"}
```

## Status

`GET /verify-age/{task_id}` returns `{"task_id", "status"}` until the job finishes, and the full result once `status` is `completed`.

| Status | Description |
| - | - |
| `running` | Research is in progress. |
| `completed` | Research finished. The response includes the result fields below. |
| `failed`, `cancelled`, `terminated`, `timed_out` | Ended without a result. |

## Response

| Field | Type | Description |
| - | - | - |
| `task_id` | string | The job ID. |
| `status` | string | `completed`. |
| `date_of_birth.day` | integer or null | Day of birth, 1–31. |
| `date_of_birth.month` | integer or null | Month of birth, 1–12. |
| `date_of_birth.year` | integer or null | Year of birth. |
| `date_of_birth.confidence` | integer | Confidence in the date, 0–100: the lowest score among the components that were established. `0` when none were. |
| `age.value` | integer or null | Age in whole years. Exact when the date of birth is known, otherwise an estimate from the evidence. |
| `age.as_of` | string | The date of this response (ISO 8601), not the date of the research: each poll returns the current date. `age.value` stays the age the research established. |
| `age.confidence` | integer | Confidence in `age.value`, 0–100. |
| `evidence` | string | How the date of birth or age was established. |
| `sources` | array of strings | URLs of the pages the determination rests on. |

Each date component is `null` unless a source establishes it, and `day` and `month` are always `null` when `year` is. `age.value` can be set while the date components are `null`.

```json theme={null}
{
  "task_id": "7f3c9a2e-1b4d-4e8a-9c6f-2d5e8b1a0c37",
  "status": "completed",
  "date_of_birth": {"day": null, "month": 3, "year": 1991, "confidence": 82},
  "age": {"value": 35, "as_of": "2026-10-09", "confidence": 80},
  "evidence": "A 2016 conference bio lists her as 25 in March 2016; a public alumni record gives a 1991 birth month of March.",
  "sources": [
    "https://example.com/conference-2016/speakers",
    "https://example.edu/alumni/jane-doe"
  ]
}
```

## Usage

```bash cURL theme={null}
curl -X POST "https://api.sixtyfour.ai/verify-age" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": {
      "name": "Jane Doe",
      "company": "Acme Corp",
      "linkedin": "https://www.linkedin.com/in/janedoe"
    }
  }'

curl "https://api.sixtyfour.ai/verify-age/TASK_ID" \
  -H "x-api-key: YOUR_API_KEY"
```

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

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

start = requests.post(
    f"{BASE_URL}/verify-age",
    headers=headers,
    json={
        "subject": {
            "name": "Jane Doe",
            "company": "Acme Corp",
            "linkedin": "https://www.linkedin.com/in/janedoe",
        }
    },
)
start.raise_for_status()
task_id = start.json()["task_id"]

while True:
    response = requests.get(f"{BASE_URL}/verify-age/{task_id}", headers=headers)
    if response.status_code in (429, 503):
        time.sleep(float(response.headers.get("Retry-After", 10)))
        continue
    response.raise_for_status()
    result = response.json()
    if result["status"] == "completed":
        print(result["date_of_birth"], result["age"])
        break
    if result["status"] != "running":
        raise RuntimeError(f"Age verification {result['status']}")
    time.sleep(10)
```

```javascript JavaScript theme={null}
const BASE_URL = "https://api.sixtyfour.ai";
const headers = { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" };

const start = await fetch(`${BASE_URL}/verify-age`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    subject: {
      name: "Jane Doe",
      company: "Acme Corp",
      linkedin: "https://www.linkedin.com/in/janedoe"
    }
  })
});
const { task_id } = await start.json();

while (true) {
  const response = await fetch(`${BASE_URL}/verify-age/${task_id}`, { headers });
  if (response.status === 429 || response.status === 503) {
    const retryAfter = Number(response.headers.get("Retry-After") ?? 10);
    await new Promise((r) => setTimeout(r, retryAfter * 1000));
    continue;
  }
  if (!response.ok) throw new Error(`Age verification status ${response.status}: ${await response.text()}`);
  const result = await response.json();
  if (result.status === "completed") {
    console.log(result.date_of_birth, result.age);
    break;
  }
  if (result.status !== "running") {
    throw new Error(`Age verification ${result.status}`);
  }
  await new Promise((r) => setTimeout(r, 10000));
}
```

## Pricing

See [Credit Costs](https://docs.sixtyfour.ai/guides/credits-and-pricing.md) for more information.

Age Verification needs no tier access: any organization with credits can call it.

## Related

* [Batch Processing](https://docs.sixtyfour.ai/guides/batch-processing.md)
* [Async Jobs](https://docs.sixtyfour.ai/api-reference/async-jobs.md)
* [Handling Errors](https://docs.sixtyfour.ai/api-reference/legacy/errors.md)
* [Credit Costs](https://docs.sixtyfour.ai/guides/credits-and-pricing.md)


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