---
title: "Calculate age in years/months/days from a DOB"
method: POST
path: "/age-calc.php"
tags: ["datetime"]
---

# Calculate age in years/months/days from a DOB

`POST /age-calc.php`

## Request

- Base URL: `https://mate.tools/api/v1`
- URL: `https://mate.tools/api/v1/age-calc.php`
- Auth: none declared

Given a date of birth and optional reference date, returns age in years/months/days, total days/weeks/months/hours/seconds, next birthday + days until, Western zodiac sign, generation label, and leap-year info for the birth year.

## Request body

- object
  - `date_of_birth` string, required
  - `reference` string
  - `timezone` string

## Response `200`

Success

## Other responses

- `400`: Malformed request
- `429`: Rate limit exceeded (60/min, 600/hour per IP). Includes Retry-After header.

---

[API](https://skmtc.dev/mate/apis/mate-tools-api.md) · [All operations](https://skmtc.dev/mate/apis/mate-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mate/apis/mate-tools-api/revisions/874670b78962?raw)