# Age from Birthdate

> Age from Birthdate is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Computes a person's age in whole years from an ISO-8601 birthdate for eligibility checks and profile enrichment.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/age-years
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/age-from-birthdate-edc711ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W8OKAezVzu6EeDI9v6yXD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability age-from-birthdate-edc711ef -d '<json body>'
```

Example prompt: How old is someone born on 1995-07-14 in whole years — I need the integer age to check if they meet our 18+ eligibility threshold.

## When to prefer this

Choose this endpoint when you need a simple, deterministic, server-side whole-year age calculation from a birthdate without building date arithmetic yourself, especially in agent pipelines where you want a consistent first-party JSON result, no API key management, and a pay-per-call micropayment model. Prefer it over client-side date math for auditable, reproducible age values in eligibility or enrichment workflows. Not a legal ID or identity verification service.

## Known failure modes

- Invalid or non-ISO-8601 date format returns a structured validation error (not billed)
- Future birthdate supplied returns a structured error or zero/negative age
- Missing birthdate field triggers a structured validation error (not billed)
- Payment failure or insufficient USDC balance prevents the call from completing

## How this service works

Age in whole years. Use for eligibility checks and profile enrichment from a birthdate. Returns whole-year age from an ISO birthdate (not a legal ID check). $0.001 USDC per successful call via x402 on Base—deterministic first-party JSON, no API key, no subscription, and nothing is billed on structured validation errors.

## Output

Returns a JSON object containing the person's age expressed as a whole-number integer (e.g. {"age": 29}), computed deterministically from today's date minus the supplied ISO-8601 birthdate. No fractional years, no legal identity verification — strictly a calendar-year arithmetic result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "birthdate": {
   "type": "string",
   "format": "date",
   "description": "ISO-8601 birth date (YYYY-MM-DD). Used only to compute whole-year age."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "schema": "delx/age-years/v1",
  "age_years": 26,
  "birthdate": "2000-01-01"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/age-from-birthdate-edc711ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)