# AgentTools Age Calculator

> AgentTools Age Calculator is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Calculates a person's exact age in years, months, and days from a date of birth, with total days lived, relative to a reference date (defaults to today UTC).

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/calculators/age-calculator?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-age-calculator-2aea253d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n8kUC8rCDD9foiyHABnsN

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 agenttools-age-calculator-2aea253d
```

Example prompt: How old exactly is someone born on 1990-03-15 — give me their age in years, months, and days as of today.

## When to prefer this

Use this endpoint when you need a precise, broken-down age calculation (years + months + days + total days) rather than just a year count. It is ideal for legal age verification, medical record contexts, birthday milestones, or any scenario where exact age granularity matters and a simple subtraction is insufficient.

## Known failure modes

- Missing 'birth' query parameter returns a 400 error
- Invalid date format (not YYYY-MM-DD) causes a parse error
- Birth date in the future may return zero or negative age
- Reference date ('on') earlier than birth date yields invalid/zero result
- Network timeout or service unavailability returns a 5xx error

## How this service works

Calculate a person's exact age in calendar years, months and days from their date of birth, plus total days lived. Reference date defaults to today (UTC). Use this when an agent needs to exact age in years, months and days.

## Output

Returns the exact age broken down into calendar years, months, and days since the given birth date, plus the total number of days lived. The reference date defaults to the current UTC date if not specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "birth"
     ],
     "properties": {
      "on": {
       "type": "string",
       "description": "Defaults to today, YYYY-MM-DD"
      },
      "birth": {
       "type": "string",
       "description": "YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttools-age-calculator-2aea253d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)