{"uid":"cap_n8kUC8rCDD9foiyHABnsN","slug":"agenttools-age-calculator-2aea253d","name":"AgentTools Age Calculator","description":"Calculate a person's exact age in calendar years, months and days from their date of birth, plus total days lived. Reference date defaults to today (UTC). Use this when an agent needs to exact age in years, months and days.","url":"https://agentstoolshub.com/api/v1/calculators/age-calculator?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["birth"],"properties":{"on":{"type":"string","description":"Defaults to today, YYYY-MM-DD"},"birth":{"type":"string","description":"YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1QjFvYL40FXVJ1EbF68Qq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates a person's exact age in years, months, and days from a date of birth, with total days lived, relative to a reference date (defaults to today UTC).","exampleAgentPrompt":"How old exactly is someone born on 1990-03-15 — give me their age in years, months, and days as of today.","exampleUseCases":[{"title":"Verify legal drinking age","prompt":"Can you calculate the exact age of someone born on 2002-11-08 and tell me their age in years, months, and days as of today so I can verify if they're old enough to purchase alcohol?"},{"title":"Birthday milestone announcement","prompt":"My grandfather was born on 1944-06-22 — how old is he exactly right now in years, months, and days, and how many total days has he lived?"},{"title":"Age at a specific historical date","prompt":"How old was someone born on 1985-04-30 on the date 2020-01-01 — I need the exact age in years, months, and days, not just the year count."}],"resultDescription":"Returns the exact age broken down into calendar years, months, and days since the given birth date, plus the total number of days lived. The reference date defaults to the current UTC date if not specified.","failureModes":["Missing 'birth' query parameter returns a 400 error","Invalid date format (not YYYY-MM-DD) causes a parse error","Birth date in the future may return zero or negative age","Reference date ('on') earlier than birth date yields invalid/zero result","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need a precise, broken-down age calculation (years + months + days + total days) rather than just a year count. It is ideal for legal age verification, medical record contexts, birthday milestones, or any scenario where exact age granularity matters and a simple subtraction is insufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:50:16.161Z","isFirstParty":false,"canonicalSlug":"agenttools-age-calculator-2aea253d"}