Age in years/months/days API

Computes precise age from a birthdate to a reference date as years, months and days (with carry/borrow), plus totals and days to the next birthday. Answers 'How old is someone born 1990-02-15 as of today?', 'Exact age in years, months and days.'.

Price$0.04per request

MethodPOST

Route/v1/datetime/age

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

datetimeagebirthdateyears-months-daysdurationnext-birthdaycalendarelapsed

API URLhttps://x402.hexl.dev/v1/datetime/age

Integration docs

Example request

{
  "birthDate": "1990-02-15",
  "now": "2026-06-04"
}

Example response

{
  "birthDate": "1990-02-15",
  "asOf": "2026-06-04",
  "years": 36,
  "months": 3,
  "days": 20,
  "totalMonths": 435,
  "totalWeeks": 1894,
  "totalDays": 13258,
  "daysToNextBirthday": 256,
  "interpretation": "36 year(s), 3 month(s), 20 day(s) old as of 2026-06-04 (13258 days total); next birthday in 256 day(s)."
}

Input schema

{
  "type": "object",
  "required": [
    "birthDate",
    "now"
  ],
  "properties": {
    "birthDate": {
      "type": "string",
      "examples": [
        "1990-02-15"
      ]
    },
    "now": {
      "type": "string",
      "examples": [
        "2026-06-04"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}