{"uid":"cap_W8OKAezVzu6EeDI9v6yXD","slug":"age-from-birthdate-edc711ef","name":"Age from Birthdate","description":"Age in whole years. Use for eligibility checks and profile enrichment from a birthdate. Returns whole-year age from an ISO birthdate (not a legal ID check). $0.001 USDC per successful call via x402 on Base—deterministic first-party JSON, no API key, no subscription, and nothing is billed on structured validation errors.","url":"https://api.delx.ai/api/v1/x402/age-years","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"birthdate":{"type":"string","format":"date","description":"ISO-8601 birth date (YYYY-MM-DD). Used only to compute whole-year age."}}},"responseSchema":{"type":"json","example":{"schema":"delx/age-years/v1","age_years":26,"birthdate":"2000-01-01"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XnfT23qHGD24vyfXa1k8K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a person's age in whole years from an ISO-8601 birthdate for eligibility checks and profile enrichment.","exampleAgentPrompt":"How old is someone born on 1995-07-14 in whole years — I need the integer age to check if they meet our 18+ eligibility threshold.","exampleUseCases":[{"title":"Age eligibility gate for signup","prompt":"A user says their birthdate is 2006-03-22 — can you check how old they are in whole years so I can decide whether they're old enough to create an account?"},{"title":"Profile enrichment from stored birthdate","prompt":"I have a user record with birthdate 1988-11-05 and I need to populate their age field in whole years for display on their profile page."},{"title":"Senior discount qualification check","prompt":"A customer claims to be 65 or older — their birthdate is 1958-04-30. Can you calculate their exact age in whole years so I can confirm they qualify for the senior discount?"}],"resultDescription":"Returns a JSON object containing the person's age expressed as a whole-number integer (e.g. {\"age\": 29}), computed deterministically from today's date minus the supplied ISO-8601 birthdate. No fractional years, no legal identity verification — strictly a calendar-year arithmetic result.","failureModes":["Invalid or non-ISO-8601 date format returns a structured validation error (not billed)","Future birthdate supplied returns a structured error or zero/negative age","Missing birthdate field triggers a structured validation error (not billed)","Payment failure or insufficient USDC balance prevents the call from completing"],"whenToPreferThis":"Choose this endpoint when you need a simple, deterministic, server-side whole-year age calculation from a birthdate without building date arithmetic yourself, especially in agent pipelines where you want a consistent first-party JSON result, no API key management, and a pay-per-call micropayment model. Prefer it over client-side date math for auditable, reproducible age values in eligibility or enrichment workflows. Not a legal ID or identity verification service.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:27.947Z","isFirstParty":false}