{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"us-federal-working-day"},"result":{"entity_type":"calculator","id":"us-federal-working-day","calculator_id":"us-federal-working-day","canonical_url":"https://tttkmbb.com/everyday/us-federal-working-day","name":"US Federal Holiday Working Day","title":"US Federal Holiday Working Day – OPM","category":"everyday","category_name":"Everyday Life","tool_name":"check_us_federal_working_day","featured_mcp_tool":true,"description":"Checks a date against the OPM federal-employee holiday schedule and the US Saturday/Sunday baseline.","use_when":"You need US federal employee or federal-office holiday status for 2026-2027.","do_not_use_when":"You need a state/local/private-employer/exchange calendar or an alternate federal work schedule without explicit in-lieu resolution.","agent_examples":["Is 2027-07-05 a US federal working day?"],"inputs":[{"name":"date","label":"Date","type":"date","required":true,"description":"Gregorian date in the pinned OPM 2026-2027 coverage.","example":"2027-07-05"}],"outputs":[{"name":"territory","label":"Territory","type":"string","decimals":4,"description":"US."},{"name":"territory_name","label":"Territory name","type":"string","decimals":4,"description":"United States."},{"name":"weekday","label":"Weekday","type":"string","decimals":4,"description":"Gregorian weekday."},{"name":"is_working_day","label":"Working day","type":"boolean","decimals":4,"description":"True when the US Saturday/Sunday baseline is a weekday and no OPM federal holiday applies."},{"name":"day_type","label":"Day type","type":"string","decimals":4,"description":"Regular weekday, regular weekend or OPM federal holiday."},{"name":"holiday_names","label":"Holiday names","type":"string_list","decimals":4,"description":"OPM federal holiday names applying on the date."},{"name":"holiday_observed","label":"Observed date","type":"boolean","decimals":4,"description":"True when the date is the OPM in-lieu/observed date for a holiday whose actual date is a weekend."},{"name":"holiday_actual_dates","label":"Actual holiday dates","type":"string_list","decimals":4,"description":"Underlying statutory holiday dates for observed events."},{"name":"weekend_days","label":"Weekend baseline","type":"string_list","decimals":4,"description":"CLDR Saturday/Sunday baseline."},{"name":"rest_day_policy","label":"Rest-day policy","type":"string","decimals":4,"description":"OPM alternative work schedules need separate in-lieu resolution."},{"name":"calendar_scope","label":"Calendar scope","type":"string","decimals":4,"description":"Federal employees and federal offices only."},{"name":"calendar_profile","label":"Calendar profile","type":"string","decimals":4,"description":"us-opm-federal-holidays."},{"name":"source_quality","label":"Source quality","type":"string","decimals":4,"description":"Official OPM schedule and federal-law references."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Pinned OPM evidence package."},{"name":"sources","label":"Sources","type":"list","decimals":4,"description":"Official OPM, federal guidance and legislation sources."}],"input_schema":{"type":"object","properties":{"date":{"description":"Gregorian date in the pinned OPM 2026-2027 coverage.","type":"string","format":"date","examples":["2027-07-05"]}},"additionalProperties":false,"required":["date"],"examples":[{"date":"2027-07-05"}]},"output_schema":{"type":"object","properties":{"territory":{"description":"US.","type":"string"},"territory_name":{"description":"United States.","type":"string"},"weekday":{"description":"Gregorian weekday.","type":"string"},"is_working_day":{"description":"True when the US Saturday/Sunday baseline is a weekday and no OPM federal holiday applies.","type":"boolean"},"day_type":{"description":"Regular weekday, regular weekend or OPM federal holiday.","type":"string"},"holiday_names":{"description":"OPM federal holiday names applying on the date.","type":"array","items":{"type":"string"}},"holiday_observed":{"description":"True when the date is the OPM in-lieu/observed date for a holiday whose actual date is a weekend.","type":"boolean"},"holiday_actual_dates":{"description":"Underlying statutory holiday dates for observed events.","type":"array","items":{"type":"string"}},"weekend_days":{"description":"CLDR Saturday/Sunday baseline.","type":"array","items":{"type":"string"}},"rest_day_policy":{"description":"OPM alternative work schedules need separate in-lieu resolution.","type":"string"},"calendar_scope":{"description":"Federal employees and federal offices only.","type":"string"},"calendar_profile":{"description":"us-opm-federal-holidays.","type":"string"},"source_quality":{"description":"Official OPM schedule and federal-law references.","type":"string"},"dataset_version":{"description":"Pinned OPM evidence package.","type":"string"},"sources":{"description":"Official OPM, federal guidance and legislation sources.","type":"array"}}},"formula":"is_working_day = US weekday baseline and no OPM federal holiday","method":"Apply the pinned OPM observed-date schedule on top of the CLDR US weekend baseline.","sources":[{"name":"U.S. Office of Personnel Management Federal Holidays","url":"https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/","type":"government","published_at":"2026-09-29"},{"name":"OPM Federal Holidays - In Lieu Of Determination","url":"https://www.opm.gov/policy-data-oversight/pay-leave/work-schedules/fact-sheets/federal-holidays-in-lieu-of-determination/","type":"government_guidance"},{"name":"5 U.S.C. 6103","url":"https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title5-section6103&num=0&edition=prelim","type":"legislation"}],"freshness":{"type":"static","max_age_seconds":null,"note":"OPM publishes annual federal schedules; refresh only after official review."},"examples":[{"name":"Observed Independence Day","inputs":{"date":"2027-07-05"},"expected":{"is_working_day":false,"holiday_observed":true},"url":"https://tttkmbb.com/api/v1/calculate/us-federal-working-day?date=2027-07-05"}],"faq":[{"q":"Does this cover US state holidays?","a":"No. It is limited to OPM federal employees and federal offices."}],"tags":["United States","US","OPM","federal holiday","working day"],"related":[{"calculator_id":"us-federal-add-working-days","reason":"Offset using the same OPM evidence package."}],"links":{"html":"https://tttkmbb.com/everyday/us-federal-working-day","markdown":"https://tttkmbb.com/everyday/us-federal-working-day.md","json":"https://tttkmbb.com/everyday/us-federal-working-day.json","api":"https://tttkmbb.com/api/v1/calculate/us-federal-working-day","schema":"https://tttkmbb.com/api/v1/calculators/us-federal-working-day","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-27"},"timestamp":"2026-09-29T12:58:16Z","links":{"mcp":"https://tttkmbb.com/mcp","a2a":"https://tttkmbb.com/a2a","openapi":"https://tttkmbb.com/openapi.json","llms_txt":"https://tttkmbb.com/llms.txt","feed":"https://tttkmbb.com/feed.xml","ard":"https://tttkmbb.com/.well-known/ard.json","ai_catalog":"https://tttkmbb.com/.well-known/ai-catalog.json","agent_card":"https://tttkmbb.com/.well-known/agent-card.json","mcp_server_card":"https://tttkmbb.com/mcp/server-card","mcp_server_card_legacy":"https://tttkmbb.com/.well-known/mcp-server-card.json","ai_plugin":"https://tttkmbb.com/.well-known/ai-plugin.json","agent_capabilities":"https://tttkmbb.com/agent-capabilities.json","docs":"https://tttkmbb.com/docs/index.md","privacy":"https://tttkmbb.com/docs/privacy","terms":"https://tttkmbb.com/docs/terms","support":"https://tttkmbb.com/docs/support","china_work_calendar_data":"https://tttkmbb.com/api/v1/data/china-work-calendar/2026","uk_bank_holidays_data":"https://tttkmbb.com/api/v1/data/uk-bank-holidays","iana_tzdb_data":"https://tttkmbb.com/api/v1/data/iana-tzdb","global_working_day_data":"https://tttkmbb.com/api/v1/data/global-working-day","global_public_holiday_data":"https://tttkmbb.com/api/v1/data/global-public-holidays","global_working_day_reference_data":"https://tttkmbb.com/api/v1/data/global-working-day-reference","australia_public_holidays_data":"https://tttkmbb.com/api/v1/data/australia-public-holidays","us_federal_holidays_data":"https://tttkmbb.com/api/v1/data/us-federal-holidays","canada_federal_holidays_data":"https://tttkmbb.com/api/v1/data/canada-federal-holidays","japan_national_holidays_data":"https://tttkmbb.com/api/v1/data/japan-national-holidays","india_central_government_holidays_data":"https://tttkmbb.com/api/v1/data/india-central-government-holidays","uae_federal_holidays_data":"https://tttkmbb.com/api/v1/data/uae-federal-holidays","new_zealand_public_holidays_data":"https://tttkmbb.com/api/v1/data/new-zealand-public-holidays","south_africa_public_holidays_data":"https://tttkmbb.com/api/v1/data/south-africa-public-holidays","ireland_public_holidays_data":"https://tttkmbb.com/api/v1/data/ireland-public-holidays","france_public_holidays_data":"https://tttkmbb.com/api/v1/data/france-public-holidays","argentina_public_holidays_data":"https://tttkmbb.com/api/v1/data/argentina-public-holidays","uzbekistan_public_holidays_data":"https://tttkmbb.com/api/v1/data/uzbekistan-public-holidays","vietnam_public_holidays_data":"https://tttkmbb.com/api/v1/data/vietnam-public-holidays","bangladesh_public_holidays_data":"https://tttkmbb.com/api/v1/data/bangladesh-public-holidays","sri_lanka_public_holidays_data":"https://tttkmbb.com/api/v1/data/sri-lanka-public-holidays","nigeria_public_holidays_data":"https://tttkmbb.com/api/v1/data/nigeria-public-holidays","ghana_public_holidays_data":"https://tttkmbb.com/api/v1/data/ghana-public-holidays","pakistan_public_holidays_data":"https://tttkmbb.com/api/v1/data/pakistan-public-holidays","kenya_public_holidays_data":"https://tttkmbb.com/api/v1/data/kenya-public-holidays","egypt_public_holidays_data":"https://tttkmbb.com/api/v1/data/egypt-public-holidays","russia_public_holidays_data":"https://tttkmbb.com/api/v1/data/russia-public-holidays","colombia_public_holidays_data":"https://tttkmbb.com/api/v1/data/colombia-public-holidays","chile_public_holidays_data":"https://tttkmbb.com/api/v1/data/chile-public-holidays","greece_public_holidays_data":"https://tttkmbb.com/api/v1/data/greece-public-holidays","kazakhstan_public_holidays_data":"https://tttkmbb.com/api/v1/data/kazakhstan-public-holidays","peru_public_holidays_data":"https://tttkmbb.com/api/v1/data/peru-public-holidays","slovakia_public_holidays_data":"https://tttkmbb.com/api/v1/data/slovakia-public-holidays","hungary_public_holidays_data":"https://tttkmbb.com/api/v1/data/hungary-public-holidays","czech_public_holidays_data":"https://tttkmbb.com/api/v1/data/czech-public-holidays","croatia_public_holidays_data":"https://tttkmbb.com/api/v1/data/croatia-public-holidays","slovenia_public_holidays_data":"https://tttkmbb.com/api/v1/data/slovenia-public-holidays","estonia_public_holidays_data":"https://tttkmbb.com/api/v1/data/estonia-public-holidays","luxembourg_public_holidays_data":"https://tttkmbb.com/api/v1/data/luxembourg-public-holidays","malta_public_holidays_data":"https://tttkmbb.com/api/v1/data/malta-public-holidays","lithuania_public_holidays_data":"https://tttkmbb.com/api/v1/data/lithuania-public-holidays","latvia_public_holidays_data":"https://tttkmbb.com/api/v1/data/latvia-public-holidays","bulgaria_public_holidays_data":"https://tttkmbb.com/api/v1/data/bulgaria-public-holidays","romania_public_holidays_data":"https://tttkmbb.com/api/v1/data/romania-public-holidays","brazil_federal_holidays_data":"https://tttkmbb.com/api/v1/data/brazil-federal-holidays","mexico_labor_rest_days_data":"https://tttkmbb.com/api/v1/data/mexico-labor-rest-days","philippines_public_holidays_data":"https://tttkmbb.com/api/v1/data/philippines-public-holidays","indonesia_public_holidays_data":"https://tttkmbb.com/api/v1/data/indonesia-public-holidays","south_korea_public_holidays_data":"https://tttkmbb.com/api/v1/data/south-korea-public-holidays","italy_public_holidays_data":"https://tttkmbb.com/api/v1/data/italy-public-holidays","spain_public_holidays_data":"https://tttkmbb.com/api/v1/data/spain-national-holidays","germany_public_holidays_data":"https://tttkmbb.com/api/v1/data/germany-national-holidays","netherlands_public_holidays_data":"https://tttkmbb.com/api/v1/data/netherlands-public-holidays","belgium_public_holidays_data":"https://tttkmbb.com/api/v1/data/belgium-public-holidays","austria_public_holidays_data":"https://tttkmbb.com/api/v1/data/austria-public-holidays","poland_public_holidays_data":"https://tttkmbb.com/api/v1/data/poland-public-holidays","portugal_public_holidays_data":"https://tttkmbb.com/api/v1/data/portugal-public-holidays","denmark_public_holidays_data":"https://tttkmbb.com/api/v1/data/denmark-public-holidays","sweden_public_holidays_data":"https://tttkmbb.com/api/v1/data/sweden-public-holidays","norway_public_holidays_data":"https://tttkmbb.com/api/v1/data/norway-public-holidays","finland_public_holidays_data":"https://tttkmbb.com/api/v1/data/finland-public-holidays","switzerland_public_holidays_data":"https://tttkmbb.com/api/v1/data/switzerland-public-holidays","taiwan_government_work_calendar_data":"https://tttkmbb.com/api/v1/data/taiwan-government-work-calendar","hong_kong_general_holidays_data":"https://tttkmbb.com/api/v1/data/hong-kong-general-holidays","turkey_public_holidays_data":"https://tttkmbb.com/api/v1/data/turkey-public-holidays","saudi_financial_holidays_data":"https://tttkmbb.com/api/v1/data/saudi-financial-holidays","thailand_financial_holidays_data":"https://tttkmbb.com/api/v1/data/thailand-financial-holidays","working_day_catalog":"https://tttkmbb.com/api/v1/data/working-day-calendars","html":"https://tttkmbb.com/everyday/us-federal-working-day","markdown":"https://tttkmbb.com/everyday/us-federal-working-day.md","api":"https://tttkmbb.com/api/v1/calculate/us-federal-working-day"}}