{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"retirement-countdown"},"result":{"entity_type":"calculator","id":"retirement-countdown","calculator_id":"retirement-countdown","canonical_url":"https://tttkmbb.com/time/retirement-countdown","name":"Retirement Countdown Calculator","title":"Retirement Countdown Calculator – Retirement Date and Days, Weeks and Working Days Remaining","category":"time","category_name":"Time & Geography","tool_name":"calculate_retirement_countdown","featured_mcp_tool":false,"description":"Computes the date on which a person reaches a chosen retirement age from their date of birth and counts the days, weeks, calendar months and Monday–Friday working days remaining from a reference date.","use_when":"You want to know when someone reaches retirement age (default 67, the US full retirement age for people born in 1960 or later) and how long is left.","do_not_use_when":"You need the savings required to retire (use retirement-savings or fire-number) or a pension-rule specific eligibility date; national retirement ages vary and must be entered explicitly.","inputs":[{"name":"birth_date","label":"Date of birth","type":"date","required":true,"description":"Date of birth (YYYY-MM-DD).","example":"1970-06-15"},{"name":"retirement_age","label":"Retirement age","type":"integer","unit":"years","required":false,"default":67,"min":18,"max":120,"description":"Age at which retirement starts; 67 is the US Social Security full retirement age for people born in 1960 or later.","example":67},{"name":"as_of_date","label":"Count from","type":"date","required":false,"default":"today","description":"Reference date for the countdown; defaults to the current UTC date.","example":"2026-09-23"}],"outputs":[{"name":"retirement_date","label":"Retirement date","type":"date","decimals":4,"description":"The birthday on which retirement_age is reached (29 February birthdays map to 1 March in common years)."},{"name":"retirement_weekday","label":"Weekday","type":"string","decimals":4,"description":"Day of the week of the retirement date."},{"name":"current_age_years","label":"Current age","type":"integer","unit":"years","decimals":4,"description":"Completed years of age on as_of_date."},{"name":"days_remaining","label":"Days remaining","type":"integer","unit":"days","decimals":4,"description":"retirement_date − as_of_date; negative if the date has passed."},{"name":"weeks_remaining","label":"Weeks remaining","type":"number","unit":"weeks","decimals":1,"description":"days_remaining / 7."},{"name":"months_remaining","label":"Calendar months remaining","type":"integer","unit":"months","decimals":4,"description":"Whole calendar months between the two dates (negative if passed)."},{"name":"years_remaining","label":"Years remaining","type":"number","unit":"years","decimals":2,"description":"days_remaining / 365.2425."},{"name":"remaining_text","label":"Time remaining","type":"string","decimals":4,"description":"Years, months and days remaining ('ago' when the date has passed)."},{"name":"working_days_remaining","label":"Working days remaining","type":"integer","unit":"days","decimals":4,"description":"Monday–Friday days after as_of_date up to and including retirement_date (public holidays not excluded); 0 if passed."},{"name":"status","label":"Status","type":"string","decimals":4,"description":"Countdown summary or notice that the retirement date has passed."}],"input_schema":{"type":"object","properties":{"birth_date":{"description":"Date of birth (YYYY-MM-DD).","type":"string","format":"date","examples":["1970-06-15"]},"retirement_age":{"description":"Age at which retirement starts; 67 is the US Social Security full retirement age for people born in 1960 or later. Unit: years.","type":"integer","minimum":18,"maximum":120,"default":67,"examples":[67],"x-unit":"years"},"as_of_date":{"description":"Reference date for the countdown; defaults to the current UTC date.","type":"string","format":"date","default":"today","examples":["2026-09-23"]}},"additionalProperties":false,"required":["birth_date"]},"output_schema":{"type":"object","properties":{"retirement_date":{"description":"The birthday on which retirement_age is reached (29 February birthdays map to 1 March in common years).","type":"string","format":"date"},"retirement_weekday":{"description":"Day of the week of the retirement date.","type":"string"},"current_age_years":{"description":"Completed years of age on as_of_date. Unit: years.","type":"integer","x-unit":"years"},"days_remaining":{"description":"retirement_date − as_of_date; negative if the date has passed. Unit: days.","type":"integer","x-unit":"days"},"weeks_remaining":{"description":"days_remaining / 7. Unit: weeks.","type":"number","x-unit":"weeks"},"months_remaining":{"description":"Whole calendar months between the two dates (negative if passed). Unit: months.","type":"integer","x-unit":"months"},"years_remaining":{"description":"days_remaining / 365.2425. Unit: years.","type":"number","x-unit":"years"},"remaining_text":{"description":"Years, months and days remaining ('ago' when the date has passed).","type":"string"},"working_days_remaining":{"description":"Monday–Friday days after as_of_date up to and including retirement_date (public holidays not excluded); 0 if passed. Unit: days.","type":"integer","x-unit":"days"},"status":{"description":"Countdown summary or notice that the retirement date has passed.","type":"string"}}},"formula":"retirement_date = birth_date + retirement_age years; days_remaining = retirement_date − as_of_date; weeks = days / 7; years = days / 365.2425; months = calendar months between the dates","sources":[{"name":"US Social Security Administration – Retirement age and benefit reduction","url":"https://www.ssa.gov/benefits/retirement/planner/agereduction.html","type":"government","retrieved_at":"2026-09-24"},{"name":"Gregorian calendar – leap-year rule and month lengths (Wikipedia)","url":"https://en.wikipedia.org/wiki/Gregorian_calendar","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"daily","max_age_seconds":86400,"note":"Depends on the current date unless the date is supplied."},"examples":[{"name":"Born 1970-06-15, retire at 67, as of 2026-09-23","inputs":{"birth_date":"1970-06-15","retirement_age":67,"as_of_date":"2026-09-23"},"expected":{"retirement_date":"2037-06-15","retirement_weekday":"Monday","current_age_years":56,"days_remaining":3918,"weeks_remaining":559.7,"months_remaining":128,"years_remaining":10.73,"remaining_text":"10 years 8 months 23 days","working_days_remaining":2798},"url":"https://tttkmbb.com/api/v1/calculate/retirement-countdown?birth_date=1970-06-15&retirement_age=67&as_of_date=2026-09-23"},{"name":"Born 1960-03-01, retire at 65, as of 2026-09-23 (already passed)","inputs":{"birth_date":"1960-03-01","retirement_age":65,"as_of_date":"2026-09-23"},"expected":{"retirement_date":"2025-03-01","days_remaining":-571,"months_remaining":-18,"remaining_text":"1 year 6 months 22 days ago","working_days_remaining":0},"url":"https://tttkmbb.com/api/v1/calculate/retirement-countdown?birth_date=1960-03-01&retirement_age=65&as_of_date=2026-09-23"}],"faq":[{"q":"Which retirement age should I enter?","a":"The age that applies to your scheme: 67 for full US Social Security benefits (born 1960+), 66–67 for the UK State Pension, 65–67 in most EU countries, 60–65 for many occupational pensions. The calculator applies whatever you enter."},{"q":"How are working days counted?","a":"Every Monday to Friday between the day after as_of_date and the retirement date inclusive; public holidays and leave are not subtracted."}],"tags":["retirement countdown","days until retirement","retirement date","when can I retire","working days left"],"related":[{"calculator_id":"age","reason":"Exact current age with next birthday."},{"calculator_id":"days-until","reason":"Countdown to any other date."},{"calculator_id":"compound-interest","reason":"Grow retirement savings over the remaining years."}],"links":{"html":"https://tttkmbb.com/time/retirement-countdown","markdown":"https://tttkmbb.com/time/retirement-countdown.md","json":"https://tttkmbb.com/time/retirement-countdown.json","api":"https://tttkmbb.com/api/v1/calculate/retirement-countdown","schema":"https://tttkmbb.com/api/v1/calculators/retirement-countdown","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T01:47:04Z","next_actions":[{"tool":"run_calculator","calculator_id":"retirement-countdown","reason":"Run Retirement Countdown Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/time/retirement-countdown.md"}}