Age Verification

Age Verification researches public sources to establish a person’s date of birth, or an age estimate grounded in evidence when the exact date isn’t public, and returns the evidence and sources behind it. For when and how to use it in a trust-and-safety or KYC flow, see the Age Verification guide.

Endpoint

POST https://api.sixtyfour.ai/verify-age
GET  https://api.sixtyfour.ai/verify-age/{task_id}

API Reference

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

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 accepted as aliases for subject, so a People Intelligence request body works unchanged. The research plan, fields and tier are fixed; struct, tier and webhook_url are not accepted. The response is the job handle:

{"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`	The job hit an error.
`cancelled`	The job was cancelled.
`terminated`	The job was terminated.
`timed_out`	The job ran out of time.

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	ISO date `age.value` was calculated for.
`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.

{
  "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

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"

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:
    result = requests.get(f"{BASE_URL}/verify-age/{task_id}", headers=headers).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)

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 result = await (await fetch(`${BASE_URL}/verify-age/${task_id}`, { headers })).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

Each POST /verify-age is charged at the high tier rate of People Intelligence. Polling is free. See Credits & Pricing Guide for more information. Age Verification runs high tier research but does not need high tier access: any org with credits can call it.

Errors

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

Get Started

Intelligence API

Search API

Workflows API

Monitors API

Webhooks

Troubleshooting

Developer Tools

Endpoint

API Reference

Request

Status

Response

Usage

Pricing

Errors

​Endpoint

API Reference

​Request

​Status

​Response

​Usage

​Pricing

​Errors

Endpoint

Request

Status

Response

Usage

Pricing

Errors