Skip to content
96Astro API

Utilities

Available

Age Calculator API

Exact age on a date in years, months and days, with the totals in months, weeks and days, the next birthday (date, weekday, days to go), the day of the week of birth and the Western Sun sign.

  • POST /v1/utilities/age-calculator
  • 1 credit
Request
curl https://api.96astroapi.com/v1/utilities/age-calculator \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "date_of_birth": "1990-10-18",
      "on_date": "2026-11-19"
    }'

Overview

Exact age on a date in years, months and days, with the totals in months, weeks and days, the next birthday (date, weekday, days to go), the day of the week of birth and the Western Sun sign.

Call it with POST /v1/utilities/age-calculator. Input: date. Output: JSON, as a direct response. Each successful call costs 1 credit.

  • POST /v1/utilities/age-calculator
  • 1 credit
  • Date

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataInferred from the example response: a guide to the shape, not a contract.

  • date_of_birthstring
  • on_datestring
  • ageobject
  • total_monthsnumber
  • total_weeksnumber
  • total_daysnumber
  • next_birthdayobject
  • weekday_of_birthstring
  • western_sun_signstring
  • methodstring
  • disclaimer_sun_signstring
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and image data is shortened.

Loading the example…

Request schema and every field: the Utilities reference.

FAQ

Age Calculator API: common questions

4answers

Ask the team
01What does the Age Calculator API return?

Exact age on a date in years, months and days, with the totals in months, weeks and days, the next birthday (date, weekday, days to go), the day of the week of birth and the Western Sun sign. The response's data object includes date_of_birth, on_date, age, total_months, total_weeks, total_days, next_birthday and weekday_of_birth. See the reference for an example response.

02What input does Age Calculator need?

Date.

03How much does a Age Calculator call cost?

1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.

Send us feedback

What is it about?