{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"us-federal-working-days-between"},"result":{"entity_type":"calculator","id":"us-federal-working-days-between","calculator_id":"us-federal-working-days-between","canonical_url":"https://tttkmbb.com/everyday/us-federal-working-days-between","name":"Count US Federal Working Days","title":"Count US Federal Working Days – OPM","category":"everyday","category_name":"Everyday Life","tool_name":"count_us_federal_working_days","featured_mcp_tool":true,"description":"Counts US federal-baseline working and non-working dates using the OPM 2026-2027 schedule.","use_when":"You need an auditable federal-employee/office working-day count for a pinned year.","do_not_use_when":"You need a state/local/private-employer/exchange or alternate work-schedule calendar.","agent_examples":["Count US federal working days from 2027-07-01 to 2027-07-10."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"First date in 2026-2027.","example":"2027-07-01"},{"name":"end_date","label":"End date","type":"date","required":true,"description":"Last date in 2026-2027.","example":"2027-07-10"},{"name":"include_start_date","label":"Include start date","type":"boolean","required":false,"default":true,"description":"Whether start_date participates.","example":true},{"name":"include_end_date","label":"Include end date","type":"boolean","required":false,"default":true,"description":"Whether end_date participates.","example":true}],"outputs":[{"name":"normalized_start_date","label":"Normalized start","type":"date","decimals":4,"description":"Earlier endpoint."},{"name":"normalized_end_date","label":"Normalized end","type":"date","decimals":4,"description":"Later endpoint."},{"name":"working_days","label":"Working days","type":"integer","decimals":4,"description":"US federal-baseline working dates."},{"name":"non_working_days","label":"Non-working days","type":"integer","decimals":4,"description":"Weekend and OPM federal-holiday dates."},{"name":"federal_holidays_counted","label":"Federal holidays counted","type":"list","decimals":4,"description":"OPM events in the range."},{"name":"territory","label":"Territory","type":"string","decimals":4,"description":"US."},{"name":"territory_name","label":"Territory name","type":"string","decimals":4,"description":"United States."},{"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":{"start_date":{"description":"First date in 2026-2027.","type":"string","format":"date","examples":["2027-07-01"]},"end_date":{"description":"Last date in 2026-2027.","type":"string","format":"date","examples":["2027-07-10"]},"include_start_date":{"description":"Whether start_date participates.","type":"boolean","default":true,"examples":[true]},"include_end_date":{"description":"Whether end_date participates.","type":"boolean","default":true,"examples":[true]}},"additionalProperties":false,"required":["start_date","end_date"],"examples":[{"start_date":"2027-07-01","end_date":"2027-07-10","include_start_date":true,"include_end_date":true}]},"output_schema":{"type":"object","properties":{"normalized_start_date":{"description":"Earlier endpoint.","type":"string","format":"date"},"normalized_end_date":{"description":"Later endpoint.","type":"string","format":"date"},"working_days":{"description":"US federal-baseline working dates.","type":"integer"},"non_working_days":{"description":"Weekend and OPM federal-holiday dates.","type":"integer"},"federal_holidays_counted":{"description":"OPM events in the range.","type":"array"},"territory":{"description":"US.","type":"string"},"territory_name":{"description":"United States.","type":"string"},"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":"for each included date: working_days += US federal status.is_working_day","method":"Normalize endpoints, apply endpoint flags, and count the OPM calendar over 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":"Pinned OPM 2026-2027 package."},"examples":[{"name":"US federal July 2027","inputs":{"start_date":"2027-07-01","end_date":"2027-07-10","include_start_date":true,"include_end_date":true},"expected":{"working_days":6},"url":"https://tttkmbb.com/api/v1/calculate/us-federal-working-days-between?start_date=2027-07-01&end_date=2027-07-10&include_start_date=true&include_end_date=true"}],"faq":[{"q":"Is this a general US business calendar?","a":"No. It is explicitly scoped to the OPM federal schedule."}],"tags":["United States","OPM","count working days"],"related":[{"calculator_id":"us-federal-working-day","reason":"Inspect a date and its source basis."}],"links":{"html":"https://tttkmbb.com/everyday/us-federal-working-days-between","markdown":"https://tttkmbb.com/everyday/us-federal-working-days-between.md","json":"https://tttkmbb.com/everyday/us-federal-working-days-between.json","api":"https://tttkmbb.com/api/v1/calculate/us-federal-working-days-between","schema":"https://tttkmbb.com/api/v1/calculators/us-federal-working-days-between","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-27"},"timestamp":"2026-09-29T12:58:42Z","next_actions":[{"tool":"count_us_federal_working_days","calculator_id":"us-federal-working-days-between","reason":"Run Count US Federal Working Days with the inputs above."}],"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","markdown":"https://tttkmbb.com/everyday/us-federal-working-days-between.md"}}