---
title: "Age Calculator"
method: POST
path: "/api/v1/tools/age-calculator"
tags: ["tools"]
---

# Age Calculator

`POST /api/v1/tools/age-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/age-calculator`
- Auth: HTTP bearer

Exact age on a date from a birth date: years, months and days, total days, weeks and months lived, and the date of the next birthday with the days until it. Defaults to today when asOf is left out.

## Request body

- object
  - `birthDate` string
  - `asOf` string

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `birthDate` string
    - `asOf` string
    - `years` integer
    - `months` integer
    - `days` integer
    - `totalDays` integer
    - `totalWeeks` integer
    - `totalMonths` integer
    - `nextBirthday` object
      - `date` string
      - `daysUntil` integer
      - `turning` integer

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)