Utilities
AvailableAge 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
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
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_birthstringon_datestringageobjecttotal_monthsnumbertotal_weeksnumbertotal_daysnumbernext_birthdayobjectweekday_of_birthstringwestern_sun_signstringmethodstringdisclaimer_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.
Related endpoints
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.


