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 |
| 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. |