Working Days
API for Developers
API changelog
Starting from october 2023, we log here the changes (fix or evolution) made to the API or the public holidays database
| Date | Change |
| 2026-09-29 | Argentina (AR): Corrected historical holiday start dates and transfers since 2000, restored missing exceptional holidays and published tourism bridges, and removed unsupported automatic bridges. Added Spanish and English holiday names and detailed descriptions ( holiday_language=ES or EN). The customary AR-AR profile remains available; AR-LEGAL excludes optional non-working days.Added the national holiday on 9 November 2026 and separate, disabled-by-default local options for 10 November (Córdoba/Buenos Aires City) and 11 November (Buenos Aires Province). Custom holiday masks now have 35 positions. Existing 21-position masks are accepted and converted with new options OFF, preserving existing choices. Regenerate masks from the configuration catalogue before editing individual positions. The 2012 exceptional holidays and census holidays now have independent options. Fixed disabled Güemes settings and coincident half-day/full-day holidays. |
| 2026-09-28 | Colombia (CO): Corrected overlapping half-day holidays. Added configuration=CO-LEGAL for statutory national holidays; standard (also CO-CO) retains optional Easter Sunday. Sunday weekly rest remains configured separately.Holiday names and detailed descriptions are now available in Spanish and English ( holiday_language=ES or EN). Descriptions explain Monday transfers and the Chiquinquirá holiday from 2026.The configuration parameter is now applied. Legacy 19-option custom masks are accepted with Chiquinquirá inserted OFF at position 12 (counting from 1); current 20-option masks retain all choices. Both presets include the new statutory holiday. |
| 2026-09-28 | Mexico (MX): Holiday names and descriptions are now available in Spanish and English ( holiday_language=ES or EN), including historical applicability periods.Corrected historical holidays since 2000: Constitution Day and Revolution Day move to Mondays only from 2006; Benito Juárez Day only from 2007. Presidential inauguration is 1 October from 2024, instead of 1 December. Morelos's birthday is 30 September. Added the nine confirmed ordinary federal election holidays from 2000 to 2024 and corrected overlapping half-day holiday settings. Added configuration=MX-LEGAL for national statutory holidays. The existing standard profile (also MX-MX) keeps Good Friday; the legal profile excludes it. Local election holidays and sector-specific closures are outside these national profiles.Custom masks now contain 28 options: election days are inserted at position 17 (counting from 1). Legacy 27-option masks are accepted with the new option OFF; existing choices are preserved. Both national presets enable elections. Holiday descriptions explain legal status and historical periods. |
| 2026-09-27 | South Africa (ZA): Added missing election holidays since 2000, including the proclaimed election day on 4 November 2026, the millennium holidays on 2–3 January 2000, 2 May 2008, and 27 December 2011, 2016 and 2022. Corrected Christmas Sunday observance when Day of Goodwill is disabled, and overlapping half-day holiday settings. The national preset includes these dates. Existing custom profiles keep new exceptional-holiday options disabled; enable them if needed. The election option now covers all published election dates. Custom holiday masks now contain 17 positions instead of 14, with new positions 2, 8 and 17 (counting from 1). Legacy 14-position masks retain their previous choices. |
| 2026-09-27 | Brazil (BR): Added English holiday names and descriptions ( holiday_language=EN).Added the optional BR-LEGAL configuration for recurring statutory national holidays, excluding local holidays and optional closures. This excludes Carnival, Corpus Christi and Good Friday; All Souls' Day starts in 2003 and Black Consciousness Day in 2024. Exceptional election holidays are outside this recurring calendar.The existing default configuration keeps Carnival Tuesday and Corpus Christi. Their descriptions now explain that observance depends on local law, sector or employer. Corrected historical regional holiday start/end dates, Pernambuco's March 6 holiday, Santa Catarina's Sunday transfers and the documented 2020–2021 transfers in São Paulo, Sergipe and Piauí. Black Consciousness Day now follows the national start in 2024 and earlier regional applicability. Added regional options for Catholic Day (Acre), Our Lady of Penha (Espírito Santo), Saint Peter's Day (Alagoas) and Our Lord of Bonfim (Tocantins), with Portuguese and English labels. Removed Rondônia's Evangelical Day from the Acre preset. Overlapping half-day holidays now combine correctly. Custom holiday masks now contain 57 options instead of 53. Four new options are inserted at zero-based indices 3, 16, 24 and 33; existing choices shift accordingly. API versions 1.2–1.3 accept legacy 53-option masks and converts them with the new options OFF. Preset codes remain unchanged and enable their applicable new regional holidays. |
| 2026-09-24 | France (FR) — API 1.3: Fixed a regression that could incorrectly count French school holidays as non-working days when no custom profile was supplied. School holidays alone no longer reduce working days or working hours by default. Public holidays, weekends and custom profile settings remain respected, including profiles that explicitly treat school holidays as non-working days. Added the optional school_holidays_as_working_days parameter for France: 1 keeps school holidays working, subject to the other calendar rules; 0 treats them as non-working, unless overridden by custom working dates.An explicit value overrides the profile setting for the calculation without changing the saved profile. If omitted, the profile setting is preserved; without a profile, the default is 1. Invalid values or use with a country other than FR return HTTP 400. See Advanced parameters.
|
| 2026-09-23 | Switzerland (CH): Completed German, French, Italian and English holiday names, descriptions and settings labels. Corrected the Näfels Pilgrimage when the first Thursday in April falls in Holy Week. Neuchâtel now observes 2 January and 26 December when the preceding holiday falls on Sunday; Labour Day applies from 2010 in its cantonal configurations. Corrected the Appenzell region codes (CH-AR: Ausserrhoden; CH-AI: Innerrhoden), removed All Saints' Day from Ausserrhoden and applied the Tuesday/Saturday exception for Saint Stephen's Day in both cantons. Corrected Zurich city staff afternoon holidays. Separated Bern and Glarus administrative leave into Kantonsverwaltung configurations; the ordinary Bern, Glarus and Schwyz presets no longer include 24 and 31 December. Added regional configurations for Le Landeron, Bucheggberg and Oberegg. Corrected Geneva's Restoration Day name and the Monday after the Federal Fast. Coinciding holidays retain both names and combine complementary half-days into a full holiday. Existing custom masks keep their 29 positions. |
| 2026-09-23 | Italy (IT): English holiday names are now available with holiday_language=EN, together with English descriptions and settings labels. Added the exceptional holiday on 17 March 2011 and Saint Francis of Assisi on 4 October from 2026. Republic Day on 2 June now applies from 2001. Preset configurations now identify Easter Sunday as a holiday. Coinciding holidays retain both names and correctly combine half-day closures. Clarified the school/contractual scope of Sardinia's 28 April option. Custom holiday masks expand from 17 to 19 positions: the new options occupy zero-based positions 2 and 13. Valid legacy 17-position masks are converted automatically with both new options OFF; existing choices are preserved. Clients constructing 19-position masks must use the new order. |
| 2026-09-20 | Austria (AT): English holiday names are now available with holiday_language=EN, along with English holiday descriptions and settings labels. Corrected the Wiener Börse configuration for historical holiday trading, including trading on Whit Monday from 2023. Coinciding holidays now retain both names and combine half-day closures correctly. Clarified regional holiday options and the Good Friday rule applicable through 2018. The 22 holiday-option positions are unchanged. |
| 2026-09-19 | Luxembourg (LU): The banking configuration now closes only the afternoon of 24 December. Custom configurations keep their selected duration. Coinciding holidays now retain both names and correctly combine half-day options, including Europe Day and Ascension on 9 May 2024. Added holiday descriptions and translated settings labels in French, English, German and Luxembourgish. |
| 2026-09-19 | Portugal (PT): Corrected the suspension of Corpus Christi, 5 October, 1 November and 1 December in 2013–2015. Easter Sunday is treated as a statutory holiday from 2004, and Madeira's 26 December holiday from 2002. English is available through holiday_language=EN. |
| 2026-09-19 | Estonia (EE): Corrected Christmas Eve: 24 December is a public holiday from 2005, not in 2000–2004. |
| 2026-09-14 | Slovenia (SI): Corrected 2 January: not a public holiday in 2013–2016. Added the exceptional Solidarity Day on 14 August 2023. Added English and Slovenian holiday descriptions and visible applicability periods in settings. December 26 now uses its historical name, Independence Day, before 2005. Custom holiday masks now contain 16 options: Solidarity Day is inserted at zero-based index 10, shifting subsequent options by one. Legacy 15-option masks retain existing choices; the new option defaults to OFF for existing custom configurations. |
| 2026-09-13 | Serbia (RS): Corrected Sunday substitute days for New Year, Statehood Day, Labour Day and Armistice Day, including overlaps with Orthodox Easter. Removed automatic substitutes after Christmas. Corrected historical start years: general Christmas/Easter and 15 February from 2002; 16 February and Armistice Day from 2012. Added historical holidays for 2000–2001 (28 March, 7 July, 29–30 November) and 2000–2006 (27 April). Added English and Serbian descriptions and visible applicability periods in settings. Corrected overlapping half-day holidays. Custom masks now have 17 options, with historical options inserted at zero-based indices 5, 10, 13, 15 and 16. Legacy 12-option masks preserve all existing choices; new options default to OFF for existing custom configurations. |
| 2026-09-13 | Croatia (HR): Corrected historical Statehood Day dates (25 June in 2002–2019, otherwise 30 May from 1991), holiday start years and overlapping half-day holidays. Added Independence Day on 8 October for 2002–2019 and the non-working parliamentary election day on 17 April 2024. Added English and Croatian descriptions and visible applicability periods in settings. Custom holiday masks now contain 16 options: new zero-based indices 4 (2024 election) and 11 (historical Independence Day). Legacy 14-option masks retain existing choices; both new options default to OFF for existing custom configurations. |
| 2026-09-12 | Czech Republic (CZ): Corrected historical holidays: Good Friday applies from 2016, and 28 September and 17 November from 2000. Added Czech holiday names and descriptions (holiday_language=CS), with applicable periods displayed in settings. |
| 2026-09-12 | Bulgaria (BG): Added 31 December 2025 to the existing Euro Adoption option, which also covers 2 January 2026. Corrected weekend substitute days, including 27 December 2017 and 2023 and 4 May 2021. Tuesday 4 May 2027 is also a non-working day, as the substitute day for Labour Day (1 May). Christmas substitutes now follow their respective holiday options. Automatic substitutions apply from 2017; earlier calendars do not yet include all annual government transfers. Coinciding holidays now retain both names and combine half-day settings correctly. Added English, Bulgarian and French holiday descriptions and clarified the two dates covered by the Euro Adoption option in settings. |
| 2026-09-12 | Slovakia (SK): Constitution Day is no longer a day off from 2024, and Freedom and Democracy Day from 2025. The 8 May and 15 September holidays are not days off in 2026; they return in 2027 under current law. Corrected historical applicability of 8 May (from 1997) and 17 November (2001–2024). Added the one-off holiday on 30 October 2018. Added Slovak holiday names and descriptions (holiday_language=SK), with applicable periods shown in settings. Custom holiday masks now have 16 options: the 2018-only holiday is inserted at index 10 (11th position), shifting subsequent options by one. Existing 15-option masks are automatically converted with the new option OFF; the standard calendar includes it. |
| 2026-09-11 | Romania (RO): Corrected historical applicability: Pentecost and Assumption from 2009, St. Andrew's Day from 2012, Union Day and Children's Day from 2017, and Good Friday from 2018. Coinciding holidays now retain both names and combine half-day settings correctly, including Pentecost Monday and Children's Day on 1 June 2026. Clarified the Orthodox calendar profile and added English and Romanian holiday descriptions with applicable years in settings. |
| 2026-09-11 | Belarus (BY): Added the missing day-off transfers and compensating working Saturdays for 2025 and 2026. Corrected the activation of the 2024 transfers. For Monday-Friday calendars, each transfer pair now follows its related holiday option, including half-day settings. Disabling that option disables both dates of the transfer. Corrected the default calendar name and holiday descriptions in English, Russian and Belarusian. |
| 2026-09-09 | India (IN): Expanded from a single calendar profile to 74 configurations, covering central government, national holidays, states, union territories and banking calendars. |
| 2026-09-08 | Finland (FI): Coincident holidays now combine half-day closures and retain both names. Historical dates for Epiphany, Ascension, Midsummer and All Saints have been corrected. Added historical Pentecost preparation day (1973–1991) and Whit Monday (through 1972). Holiday names and descriptions are available in English, Finnish and Swedish. The mask now contains 17 positions: preparation day is the 8th character and Whit Monday the 10th, surrounding Whit Sunday. Existing 15-character custom masks remain accepted with both additions OFF. Clients building new masks must shift the former Whit Sunday to position 9 and subsequent options two positions to the right. The default enables the historical options; current-year closures are unchanged. |
| 2026-09-08 | Sweden (SE): Disabling Labour Day now leaves 1 May open. Coincident holidays correctly combine full-day and half-day closures. National Day applies from 2005; a historical Whit Monday option covers earlier years. English and Swedish holiday names and descriptions have been completed. The holiday mask now has 23 positions: Whit Monday is inserted immediately after Whit Sunday (14th character). Existing 22-character custom masks remain accepted and insert this option as OFF; clients constructing new masks must shift subsequent choices one position to the right. The default profile enables the historical option. |
| 2026-09-08 | Denmark (DK): Corrected Fastelavn (disabled by default) to Sunday, seven weeks before Easter, and fixed coinciding half-day holidays so complementary closures form a full day. Added the Friday after Ascension Day as an optional bank holiday, disabled by default. Existing custom configurations retain their choices with the new option disabled. Added complete English and Danish holiday descriptions and localized settings labels, distinguishing bank closures and commemorations from general public holidays. |
| 2026-09-08 | Poland (PL):
Christmas Eve is now included in the default national calendar from 2025. Corrected historical treatment of Epiphany from 2011 and Victory Day from 2015 (8 May). |
| 2026-09-07 |
Israel (IL):
Added Knesset election day at holiday-mask index 27 (28th option) (27th october 2026) Corrected Purim and the Fast of Esther in non-leap Hebrew years, Hanukkah to exactly eight days across year boundaries, and the intermediate Passover dates to Nisan 16-20. Applied the Thursday observances for Rabin Memorial Day and Sigd, and the documented 8 May 2025 Victory Day exception. Fixed the Tu Bishvat label and localized the normal Tenth of Tevet branch. Added local French holiday translations alongside English and Hebrew |
| 2026-09-07 |
New Zealand (NZ): Corrected South Canterbury Anniversary Day in 2022 to 11 November, retaining Queen Elizabeth II Memorial Day on 26 September. Weekend observances now depend on the normal work schedule on the original holiday date, including rotating schedules. A normally worked or partially worked weekend day no longer creates an additional Monday or Tuesday holiday. Corrected the 3 January observance category when New Year's Day falls on Sunday: disabling its observance no longer leaves a phantom holiday controlled by the 2 January setting. Combined coinciding holidays and annual-closure settings without double-counting. Complementary morning and afternoon selections now close the full day, and all matching names are retained. |
| 2026-09-07 |
Russia (RU): Corrected annual weekend transfers and working Saturdays using official federal calendars for 2019-2026. Restored the missing day off on 10 May 2024 and on 31 December 2025 and 2026. The standard Monday-Friday calendar now returns 248 working days in 2024 and 247 in both 2025 and 2026. Fixed exceptional days incorrectly controlled by the Easter setting, including phantom half-day holidays when that setting was disabled. Transfers follow their source holiday setting; ordinary Saturday exchanges follow the holiday adjoining the destination. Disabling a category cancels both ends of its exchange, and half-day selections remain consistent. Retained all eight holiday-mask positions. Orthodox Easter is now an optional observance, disabled in the default mask (11110111); existing explicit selections remain supported. Corrected the 7 January label to Orthodox Christmas and distinguished transferred days off from statutory holidays, with local English/Russian translations shared by desktop, mobile and API. |
| 2026-09-06 |
Turkey (TR): Completed the religious-holiday calendar using Diyanet's published dates through 2035, including previously missing years and years with two occurrences of the same feast. Religious dates outside the published coverage are calculated estimates and are explicitly labelled as such. Added the afternoon preceding Ramadan Feast and Sacrifice Feast, bringing their default durations to 3.5 and 4.5 days respectively. Each eve follows the corresponding feast's existing holiday setting. Corrected Sacrifice Feast in 2015 (24-27 September, with the afternoon of 23 September) and Ramadan Feast in 2016 (5-7 July, with the afternoon of 4 July). Fixed overlapping holidays so a half-day no longer masks a full holiday and coinciding holidays are counted only once while retaining both names. For example, 28 October 2012 is a full holiday because Republic Day Eve coincides with Sacrifice Feast. Corrected Labour Day's historical applicability (not a public holiday in 1981-2008) and added the exceptional public holiday on 31 December 1999. Corrected Republic Day Eve to 28 October in the settings labels, updated the name of Democracy and National Unity Day, Added Turkish holiday names through the country-specific translator. (Existing ten-category holiday masks remain compatible). |
| 2026-09-01 |
API v1.3 - New working-slot search endpoints: Added find_next_working_slot, which finds the next continuous working interval of a requested duration for one calendar. The search respects the calendar's working hours and breaks, weekends, public holidays, custom dates, rotating schedules and profile settings. Added find_common_working_slot, which finds one or more continuous working intervals shared by 2 to 20 calendars. Participant availability is compared across time zones, and results can be returned in a requested time zone with configurable result and search limits. Both endpoints return separate start and end date/time fields. Each authenticated request consumes one day from the API quota, including a valid common-slot search that returns no available slot. |
| 2026-08-31 |
Colombia (CO): Removed public holiday "Nuestra Señora del Rosario de Chiquinquirá" for years before 2026 |
| 2026-08-28 |
United Kingdom and Ireland (GB/IE): Completed a historical and regional review of the UK and Irish bank-holiday calendars. Corrected Scotland's 2 January and St Andrew's Day substitute-day rules, including their legal effective periods, and prevented duplicate weekend occurrences of St Patrick's Day and the Battle of the Boyne in Northern Ireland. Corrected the exceptional Spring Bank Holiday and Jubilee calendars for 1977, 2002, 2012 and 2022, including the previously missing Golden Jubilee bank holiday on 4 June 2002. Added Scotland's one-off World Cup bank holiday on 15 June 2026. Applied the proper historical start dates and exceptional schedules to Early May and Spring Bank Holidays instead of projecting modern rules retrospectively. Corrected Christmas and Boxing Day substitute-day labels so each holiday keeps its proper identity when 25 and 26 December fall at the weekend; for example, 26 December 2022 remains Boxing Day and 27 December is the Christmas substitute day. |
| 2026-08-27 |
Netherlands (NL): Corrected the historical coverage of the Dutch royal holiday: Queen's Day is now generated only from 1949 through 2013, on April 30 or April 29 when April 30 fell on a Sunday; King's Day is generated from 2014, on April 27 or April 26 when April 27 falls on a Sunday. Corrected the historical coverage of Liberation Day: the five-year national celebrations now start in 1960, and the modern annual national-holiday rule starts in 1990 instead of being applied retrospectively. |
| 2026-08-27 |
Belgium (BE): Added All Souls' Day on November 2 to the Federal Public Sector preset (BE-PUBLIC), while keeping it disabled in the other Belgian presets. Clarified the shared November 15 holiday bit: it is now returned as King's Day for the Federal Public Sector preset and as the German-speaking Community Holiday for the German-speaking Community preset (BE-DE). Updated the localized holiday names in English, Dutch and German. Existing custom holiday masks are migrated with the new November 2 bit disabled, preserving users' previous selections. |
| 2026-08-26 |
Canada (CA): Corrected the historical applicability of the National Day for Truth and Reconciliation so it is no longer applied globally from 2021. The holiday now starts in 2021 for the federal and Prince Edward Island calendars; 2022 for the Northwest Territories and Nunavut; 2023 for British Columbia and Yukon; and 2024 for Manitoba. The same jurisdiction-specific effective year is applied to the following-Monday observance when September 30 falls on a weekend. |
| 2026-08-26 |
Hungary (HU): Completed a review of the Hungarian public-holiday calendar and annual work-schedule exceptions. Added the officially published annual workday transfers from 2012 through 2026: designated compensating Saturdays are now treated as working days, while their paired weekdays are treated as official rest days. Corrected historical applicability of Good Friday so it is counted as a public holiday only from its legal introduction in 2017. |
| 2026-08-25 |
France (FR): Completed a historical and territorial review of the French public-holiday calendars. Added dedicated presets for Mayotte, Saint-Barthelemy and Saint-Martin, including their legally applicable abolition-of-slavery holidays on 27 April, 9 October and 27 May respectively. Corrected historical applicability so current rules are no longer projected retrospectively: Labour Day starts in 1948; Victory in Europe Day applies from 1953 through 1958, exceptionally in 1965, and again from 1982; Bastille Day starts in 1880; and Armistice Day starts in 1922. The territorial abolition-of-slavery holidays now start only from their legal introduction: 1983/1984 for the original territories and 2012 for Saint-Barthelemy and Saint-Martin. |
| 2026-08-25 |
United States (US): Completed a historical and regional review of the United States public-holiday calendars. Federal holiday rules now follow their legal historical periods: Martin Luther King Jr. Day starts in 1986; Washington's Birthday, Memorial Day, Columbus Day, Veterans/Armistice Day and Thanksgiving use the date and name applicable to each year instead of projecting the current formulas retrospectively. The official federal name Washington's Birthday is now used instead of Presidents' Day. Juneteenth is now counted from the first confirmed general non-working year of each federal, state or New York Stock Exchange calendar, with the applicable weekend observance, rather than being applied retrospectively to every configuration. Corrected the state-specific holiday represented in Alabama, Georgia, Mississippi, South Carolina and Texas, including Georgia's annual schedule and the applicable weekend-observance rules. Added the missing weekend observance of Alaska Day, Prince Jonah Kuhio Kalanianaole Day and King Kamehameha I Day. Added Inauguration Day to the District of Columbia preset: January 20 every fourth year after 1965, observed on January 21 only when January 20 falls on Sunday, with no substitute weekday when it falls on Saturday. When it coincides with Martin Luther King Jr. Day, both holiday names are returned while the date is counted only once. Corrected the District of Columbia regional code from US-DE to US-DC. |
| 2026-08-25 |
Germany (DE): Corrected the nationwide observance of Reformation Day on 31 October 2017 so that it is classified as a full public holiday in every federal state, regardless of the regional preset. Corrected Berlin's exceptional public holidays for the future: Liberation Day is now limited to 8 May 2020 and 8 May 2025, without projecting it to later five-year anniversaries. Added Berlin's one-off public holiday on 17 June 2028 for the 75th anniversary of the 1953 East German uprising, with separate localized short and detailed labels. |
| 2026-08-24 |
Australia (AU): Corrected Anzac Day observance rules by state and territory, including the state-specific arrangements confirmed for 2026 and 2027. The New South Wales Bank Holiday on the first Monday in August is no longer enabled in the general NSW preset, as it applies only to retail bank branches and certain financial institutions. It remains available for custom configurations. Easter Sunday is now applied only from its legal introduction in each state or territory, correcting historical calendars where the current rule had previously been applied retrospectively. Restored the rescheduled 2021 Royal Queensland Show holiday on 29 October 2021; the original August date remains excluded. |
| 2026-08-21 |
South Korea (KR): Completed a historical review of the national public-holiday calendar. Substitute-holiday rules are now applied only from their legal effective dates: 2014 for Seollal, Chuseok and Children's Day; 2021 for national celebration days; and 2023 for Buddha's Birthday and Christmas Day. Corrected the historical coverage of Hangeul Day, Constitution Day and Armed Forces Day, including the restoration of Constitution Day as a public holiday from 2026. Added Labor Day from 2026, nationwide election holidays, and the temporary public holiday of January 27, 2025. Corrected the Korean translation of the detailed Seollal holiday label. |
| 2026-08-21 |
New Zealand (NZ): Corrected historical New Zealand public holidays: Waitangi and ANZAC Day Mondayisation now applies only from 2014 Southland Anniversary Day uses the January rule through 2011 and Easter Tuesday from 2012, The June 2022 holiday remains Queen’s Birthday before becoming King’s Birthday in 2023. |
| 2026-08-18 |
Taiwan (TW): Year 2027 added. |
| 2026-08-17 |
Singapore (SG): Year 2027 added. |
| 2026-08-16 |
China (CN) : Added the previously missing official holiday schedules, completing coverage from 2000 through 2026. For future years, holidays whose dates can be reliably determined are now projected in advance. (On https://china.workingdays.org/ future calendars are now marked as estimates because compensatory working weekends and some holiday arrangements are announced annually by the Chinese authorities.) Japan (JP) : Aligned holiday dates with the official Cabinet Office calendar for 1955–2027. Added Japonese as a supported holiday language. |
| 2026-06-30 |
Responsive update for the API website and subscriber console:
improved mobile layouts for API documentation, supported countries, get-your-key, contact, sign in, my plan, payments, request history, changelog, PayPal, terms of use, and privacy policy pages.
Added multi-language code examples for the "Securing your code" section: PHP, Python, curl, JavaScript, Java, and C#. Navigation, account menus, tables, code examples, footers, and form controls were adjusted for small screens while preserving the desktop layouts. |
| 2026-06-19 | Colombia (CO): Added the new national public holiday "Nuestra Señora del Rosario de Chiquinquirá", created by Ley 2578 de 2026. The holiday is observed on July 9, or on the following Monday according to Ley Emiliani rules. |
| 2026-06-08 |
Austria (AT): - Added new preset configurations for private companies: - Burgenland (private Unternehmen) (AT-1_2) - Kärnten (private Unternehmen) (AT-2_2) - Niederösterreich (private Unternehmen) (AT-3_2) - Oberösterreich (private Unternehmen) (AT-4_2) - Salzburg (private Unternehmen) (AT-5_2) - Steiermark (private Unternehmen) (AT-6_2) - Tirol (private Unternehmen) (AT-7_2) - Vorarlberg (private Unternehmen) (AT-8_2) - Wien (private Unternehmen) (AT-9_2) Germany (DE): - Updated the Börse Frankfurt preset configuration (DE-XFRA) by removing Pfingstmontag and Tag der Deutschen Einheit, which are trading days for Börse Frankfurt. |
| 2026-03-12 | Austria (AT): "Silvesters" replaced with "Silvester" (December 31th) |
| 2026-01-19 | Deutschland (DE): Assigned code "DE-XFRA" to the preset configuration "Börse Frankfurt" |
| 2025-12-19 | Bulgaria (BG): January 2nd, 2026 has been added as an exceptional public holiday to celebrate the country’s entry into the eurozone. |
| 2025-12-18 |
Spain (ES) : Monday november 2nd added as a public holiday for those regional preset configurations: Andalucía, Aragón, Principado de Asturias, Castilla y León, Castilla-La Mancha, Islas Canarias, Extremadura, Comunidad de Madrid, Municipio de Madrid, Comunidad Foral de Navarra
Spain (ES) : Monday november 7th added as a public holiday for those regional preset configurations: Andalucía, Aragón, Principado de Asturias, Cantabria, Castilla y León, Extremadura, Región de Murcia, Comunidad de Madrid, Municipio de Madrid, Ciudad de Melilla, La Rioja |
| 2025-11-26 | Russia (RU) : Juanuary 9th 2026 added as a public holiday. Japan (JP) : May 6th 2026 and September 22nd 2026 added as public holidays. Hungary (HU) : Public holidays 2026 added Taiwan (TW) : Public holidays 2026 added Poland (PL) : December 24th added as a public holiday. |
| 2025-11-17 | Singapore (SG) : Public holidays 2026 added |
| 2025-11-16 |
China (CN) : Public holidays 2026 added
South-Korea (KR): May 25th 2026 added as a public holiday. South-Korea (KR): August 17th 2026 added as a public holiday. South-Korea (KR): October 5th 2026 added as a public holiday. |
| 2025-07-21 | Hong-Kong (HK): removed October 8th 2026 as a public holiday. |
| 2025-06-16 |
API 1.3.10: Adding "timezone" field to the following endpoint : /analyse, /add_working_days ,/add_working_hours , /add_duration , /configurations, /get_info_day, / get_array_info_day endpoints. This field specifies the timezone of the queried configuration using the standard IANA Time Zone naming convention (e.g., "Europe/Paris", "America/Toronto"). |
| 2025-06-07 | Adding Taiwan (TW) (public holidays coverage starting from 2025) |
| 2025-06-05 |
New endpoint /1.3/configurations (API 1.3.9) New endpoint /1.3/add_duration (API 1.3.9) |
| 2025-05-31 | New Open API JSON file https://api.workingdays.org/1.3/swagger/openapi.json and swagger doc https://api.workingdays.org/1.3/swagger/index.html |
| 2025-05-05 | Portugal (PT) / Madeira (PT-30) : Adding "Dia da Autonomia (2 de Abril, a partir de 2025)" |
| 2025-04-20 | Adding 2 vCores and 6 Go of RAM to the web hosting server |
| 2025-04-20 | Bresil / Amazonas (BR-AM) + Maranhão (BR-MA) + Piauí (BR-PI) : adding december 8th as public holiday (Dia de Nossa Senhora da Conceição) |
| 2025-04-19 | New status page https://stats.uptimerobot.com/sv7Kf7CiaZ/800367236 |
| 2025-04-14 |
Description of a custom period can now be up to 100 caracters (30 before). Endpoint /define_custom_period |
| 2025-01-15 |
New field "utc" inside the responses of the endpoints /get_info_day and /get_array_info_day . This field informs you of the UTC time zone, of the queried calendar. |
| 2024-12-05 |
Spain / Islas Baleares (ES-IB): San Esteban (December 26 ) added Korea (KR) : Children's Day 2025 shifts to May 6 Korea (KR) : Chuseok October 8th 2025 added (shifts because Day before Chuseok 2025 falls on a sunday) Japan (JP) : Grenery day 2025 shifts to May 6 Japan (JP) : Labor Thanksgiving Day 2025 shifts to November 24 |
| 2024-12-03 |
Deutschland / Berlin (DE-BE): Tag der Befreiung (May 8 2025) added Switzerland / Solothurn (CH-SO) : Tag der Arbeit (May 1) afternoon only Russia (RU) : March 10 removed |
| 2024-12-02 |
Spain (ES) : October 13 2025 added for Andalucía, Aragón, Principado de Asturias, Castilla y León, Extremadura Spain (ES) : November 10 2025 added for Municipio de Madrid (ES-MD2) Spain (ES) : June 9 added for Región de Murcia (ES-MC) Canada (CA) / Nuvanut (CA-NU) : National Day for Truth and Reconciliation (September 30) added Argentina (AR) : Día de la Soberanía Nacional 2025 translated to November 24 Argentina (AR) : August 15 and November 21 added as extra public holidays |
| 2024-11-16 |
Singapore (SG) : public holidays 2025 added Russia (RU) : public holidays 2025 added Hungary (RU) : public holidays 2025 added Northern Ireland (GB-NIR) : Orangemen's Day (July 12) shifts to July 14 |
| 2024-11-13 | China (CN) : public holidays 2025 added |
| 2024-11-04 |
Important update: Our hosting provider implemented a security policy that requires all incoming HTTP requests
to include a User-Agent header. Requests sent to the Working Days API without a User-Agent may now be refused by our servers. |
| 2024-11-04 |
Romania (RO) : Epiphany (« Boboteaza ») (6 January, from 2024) added. Romania (RO) : Synaxis of St. John the Baptist (« Soborul Sfântului Prooroc Ioan Botezătorul ») (7 January from 2024) added. |
| 2024-10-02 |
Croatia (HR) : Remembrance Day (18 November) added. República Dominicana (DO) : "Primero de Mayo" renamed into "Día del Trabajo" & date changed from "May 1st" to "closest monday to May 1st" República Dominicana (DO) : "Día de la Constitución" date changed from "November 6" to "closest monday to November 6" República Dominicana (DO) : "Día de Juan Pablo Duarte" does not translate to closest monday to 26 juanury |
| 2024-09-30 |
España (ES) -> Extremadura (ES-EX) : Día de Extremadura (September 8) does not translate to the following monday when falling on a weekend España (ES) -> Extremadura (ES-EX) : "Martes de carnaval" added (variable date) España (ES) -> Región de Murcia (ES-MC) : Diá de la Régión de Murcia (June 9) removed España (ES) -> Islas Baleares (ES-IB) : San Esteban (December 26) removed Canada (CA) -> Nova Scotia (CA-NS) : Natal day, Victoria Day, Thanksgiving, Remembrance Day removed Canada (CA) : New preset configuration created: Nova Scotia (Retail)(CA-NS) |
| 2024-09-29 |
South-Korea (KR) : "Children's day" (May 5) shifts to the next monday when falling on a weekend day South-Korea (KR) : "Armed forces day" (October 1) will be a public holiday in 2024 South-Korea (KR) : "Independence Movement day" (March 1) shifts to the next monday when falling on a weekend day |
| 2024-09-29 |
South-Korea (KR) : "Children's day" (May 5) shifts to the next monday when falling on a weekend day South-Korea (KR) : "Armed forces day" (October 1) will be a public holiday in 2024 South-Korea (KR) : "Independence Movement day" (March 1) shifts to the next monday when falling on a weekend day |
| 2024-09-28 |
España (ES) -> Castilla-La Mancha (ES-CM) : "Lunes de Pascua" removed España (ES) -> Ciudad de Ceuta (ES-CE) : "San Antonio" (June 13) added España (ES) -> Ciudad de Ceuta (ES-CE) : "Día de la Ciudad Autónoma de Ceuta" (September 2) España (ES) -> País Vasco (ES-PV) : "San José"(March 19) removed España (ES) -> Comunidad de Madrid (ES-MD) : "San José" (March 19) removed España (ES) -> Comunidad de Madrid (ES-MD) : "Santiago Apóstol"(July 25) added España (ES) : New configuration created "Municipio de Madrid" (ES-MD2) (town of Madrid) España (ES) -> Comunidad Foral de Navarra (ES-NC) : "San José" (March 19) removed España (ES) -> Comunidad Foral de Navarra (ES-NC) : "Santiago Apóstol"(July 25) added España (ES) -> La Rioja (ES-RI) : "Santiago Apóstol" (July 25) removed España (ES) -> Galicia (ES-GA) : "San José" (March 19) removed España (ES) -> Galicia (ES-GA) : "San Juan" (June 24) removed Australia (AU) -> Western Australia (AU-WA) : King's birthday on September 23 (instead of the last monday of september) |
| 2024-09-27 | Switzerland (CH) -> Schwyz (CH-SZ)
: "Immaculate Conception" (8 december) added Canada (CA) -> Alberta (CA-AB), Manitoba (CA-MB), NewFoundLand (CA-NL), Ontario (CA-ON), Prince Edward Island (CA-PE): "Heritage day / Terry Fox Day" (first monday of august) removed, as it is an optional public holiday in those provinces. Canada (CA) -> Manitoba (CA-MB) : "National Day for Truth and Reconciliation" (September 30) added Canada (CA) -> Nova Scotia (CA-NS) : "Heritage Day" (3rd Monday in February) added Canada (CA) -> Prince Edward Island (CA-PE) : Victoria Day (Monday on or before May 24) : removed as it is an optional public holiday Canada (CA) -> Prince Edward Island (CA-PE) : Thanksgiving (second Monday in October) : removed Venezuela (VE): June 20 removed from default configuration Chile (CL) : Día de los Pueblos Indígenas : Día del solsticio de invierno en el hemisferio sur |
| 2024-09-23 | Change SPAIN (ES) : "Immaculada Concepcíon" (8 december) does not translate to monday when falling on a weekend in all regions except in thoses ones : Andalucía (ES-AN), Aragón (ES-AR), Cantabria (ES-CB), Castilla y León (ES-CL), Extremadura (ES-EX), Ciudad de Melilla (ES-ML), Región de Murcia (ES-MC), Principado de Asturias (ES-AS) |
| 2024-09-04 | Changes in Switzerland (CH) -> Waadt (CH-VD) preset configuration :
|
| 2024-08-06 | API v1.3 now returns teleworking information (in the endpoints /analyse /get_info_day /get_array_info_day).
When defining a custom period (endpoint /define_custom_period), the new field teleworking has been added. |
| 2024-08-06 | API v1.3 : Endpoints /get_info_day & /get_array_info_day return new field "type_comment" to help you decode the value carried by the bit field "type" (Example: "9 == 1: weekend day + 8: custom date (working)" ) |
| 2024-06-18 | USA (US) / Configuration Nevada (US-NV) : public holiday "Nevada Day" added |
| 2024-06-10 | Canada (CA) : - Configuration Quebec (CA-QC) : public holiday "Fête Nationale du Québec" renamed into "Saint-Jean-Baptiste" - "Christmas Eve (December 24)" & "New Year's Eve (December 31)" added, unchecked by default in all configurations (not official public holidays) |
| 2024-06-04 | Brasil (BR) : fix in Corpus christi's date (variable date) |
| 2024-06-01 | Peru (PE) : public holidays "Batalla de Arica y Día de la Bandera" (June 7), "Día de la Fuerza Aérea" (July 23), "Batalla de Junin" (August 6) ,"Batalla de Ayacucho" (December 9) added. "Fiestas Patrias" renamed into "Día de la Independencia" |
| 2024-05-17 | Belgium (BE) : New preset configuration "Communauté germanophone" (BE-DE) Added. "Dimanche de la pentecôte" removed from all presets configurations. "Deuxième jour de Noël" (December 26) added to the "Secteur public" configuration (BE-PUBLIC). |
| 2024-05-10 | Guatemala (GT) has been added (public holidays language: ES) |
| 2024-05-06 | Serbia (RS) has been added (public holidays languages: EN, SR) |
| 2024-05-03 | Using the endpoint /define_custom_period (v1.3), you can now add 'notes' over a period (a note is a short text, not changing the working nature of the underlying days) |
| 2024-04-29 | When defining a working custom period (endpoint /define_custom_period v1.3), you can now define its custom work hours & wages. |
| 2024-03-23 | Ireland (GB -> IE) and Nothern Ireland (GB-> GB-NIR) : St. Patrick's Day substitute day (if march 17 falls on a weekend day) added to these preset configurations |
| 2024-03-19 | South Africa (ZA): President Cyril Ramaphosa has proclaimed Wednesday, 29 May 2024 as the date for the general national and provincial elections. For this purpose, the President has also declared an additional public holiday on 29 May 2024 (4 march 2024) |
| 2024-03-12 | Hong Kong (HK) : Chinese holiday language (ZH) addded. In English, "Day following Good Friday" has been renamed into "Holy Saturday" |
| 2024-03-07 | Argentina (AR) : 3 "Feriados Puente Turísticos" (special public holidays added by the government in order to encourage tourism) added for 2024 |
| 2024-03-07 | Brasil (BR): public holiday "Dia da Consciência Negra" (November 20) has been added to configuration "Feriados nacionais" (BR-BR) |
| 2024-03-01 | Belarus (BY) has been added (public holidays languages: RU, BE, EN) |
| 2024-02-28 | Russia (RU) : English holiday language added. 3 extra working days on week end added (Apr 27, Nov 2, Dec 28) and 4 extra public holidays added specific to 2024 (Apr 29, Apr 30, dec 30, dec 31) |
| 2024-02-27 | Ecuador (EC) has been added |
| 2024-02-26 | Peru (PE) : minor change in "Inmaculada Concepción" public holiday name |
| 2024-02-23 | Croatia (HR) has been added |
| 2024-02-22 | Slovenia (SI): "All Saints Day" (November 1st) renamed into "All Saints' Day" |
| 2024-02-12 | Estonia (EE) has been added |
| 2024-02-08 | Slovenia (SI) has been added |
| 2024-01-25 | Changes in Switzerland (CH) -> Sankt Gallen preset configuration (CH-SG):
|
| 2024-01-25 | Bug fix for the API Test Tool v1.3 (not affecting the API itself) involving the endpoint /get_info_day, where the configuration parameter was previously ignored. |
| 2023-12-18 | Introduction of the holiday_language parameter (API v1.3), enabling the selection of languages for public holidays in the API responses. |
| 2023-12-05 | In Spain (ES), January 8th 2024 is a working day (no shift in Epifanía falling on saturday 6th 2024) |
| 2023-10-30 | Singapore (SG) public holidays for 2024 have been added. |
| 2023-10-30 | Hong-Kong (HK) public holidays for 2024 have been added. |
| 2023-10-29 | China (CN) public holidays for 2024 have been added. |