Sobre la API:
Esta API recupera una lista de todos los días festivos públicos y no públicos que se celebran en un país específico. Consulta para el año actual, los años futuros y los anteriores también. Soporta 195 países en todo el mundo.
Solo pasa el país de tu elección, selecciona el año y hasta el mes y el día que deseas consultar.
Recibirás la fecha del día festivo, su nombre si es público o no, y en qué día de la semana se celebrará.
Lista de países soportados:
AD (Andorra)
AE (دولة الإمارات العربية المتحدة)
AG (Antigua y Barbuda)
AI (Anguila)
AL (Shqipëri)
AM (Հայաստան)
AO (Angola)
AR (Argentina)
AS (Samoa Americana)
AT (Österreich)
AU (Australia)
AW (Aruba)
AX (Landskapet Åland)
AZ (Azərbaycan Respublikası)
BA (Bosnia y Herzegovina)
BB (Barbados)
BD (গণপ্রজাতন্ত্রী বাংলাদেশ)
BE (Bélgica)
BF (Burkina Faso)
BG (България)
BH (مملكة البحرين)
BI (República del Burundi)
BJ (República del Benín)
BL (San Bartolomé)
BM (Bermudas)
BN (Negara Brunei Darussalam)
BO (Bolivia)
BQ (Caribisch Nederland)
BR (Brasil)
BS (Bahamas)
BW (Botsuana)
BY (Рэспубліка Беларусь)
BZ (Belice)
CA (Canadá)
CC (Islas Cocos (Keeling))
CD (República Democrática del Congo)
CF (República Centroafricana)
CG (República del Congo)
CH (Suiza)
CI (República de Côte d'Ivoire)
CK (Islas Cook)
CL (Chile)
CM (Camerún)
CN (中华人民共和国)
CO (Colombia)
CR (Costa Rica)
CU (Cuba)
CV (República de Cabo Verde)
CW (Curaçao)
CX (Isla de Navidad)
CY (Κύπρος)
CZ (Česká republika)
DE (Alemania)
DJ (República de Yibuti)
DK (Dinamarca)
DM (Dominica)
DO (República Dominicana)
DZ (الجمهورية الجزائرية الديمقراطية الشعبية)
EC (Ecuador)
EE (Eesti)
EG (جمهورية مصر العربية)
EH (الجمهورية العربية الصحراوية الديمقراطية)
ER (Eritrea)
ES (España)
ET (ኢትዮጵያ)
FI (Finlandia)
FJ (Matanitu Tugalala o Viti)
FO (Føroyar)
FR (Francia)
GA (Gabon)
GB (Reino Unido)
GD (Granada)
GE (საქართველო)
GF (Guayana Francesa)
GG (Guernsey)
GH (Ghana)
GI (Gibraltar)
GL (Kalaallit Nunaat)
GM (Gambia)
GN (Guinea)
GP (Guadalupe)
GQ (República de Guinea Ecuatorial)
GR (Ελλάδα)
GT (Guatemala)
GU (Guam)
GW (Guinea-Bisau)
GY (Guyana)
HK (香港)
HN (Honduras)
HR (Croacia)
HT (Haití)
HU (Hungría)
IC (Islas Canarias)
ID (Indonesia)
IE (Irlanda)
IL (מְדִינַת יִשְׂרָאֵל)
IM (Isla de Man)
IS (Islandia)
IT (Italia)
JE (Jersey)
JM (Jamaica)
JP (日本)
KE (Kenia)
KM (Unión de Comoras)
KN (San Cristóbal y Nieves)
KR (대한민국)
KY (Islas Caimán)
LC (Santa Lucía)
LI (Liechtenstein)
LR (Liberia)
LS (Muso oa Lesotho)
LT (Lituania)
LU (Luxemburgo)
LV (Letonia)
LY (دولة ليبيا)
MA (المملكة المغربية)
MC (Mónaco)
MD (República de Moldavia)
ME (Montenegro)
MF (San Martín)
MG (República de Madagascar)
MK (Република Македонија)
ML (República de Malí)
MQ (Martínica)
MR (الجمهورية الإسلامية الموريتانية)
MS (Montserrat)
MT (Malta)
MW (Malawi)
MX (México)
MY (Malasia)
MZ (Moçambique)
NA (Namibia)
NC (Nueva Caledonia)
NE (República del Níger)
NG (Nigeria)
NI (Nicaragua)
NL (Países Bajos)
NO (Noruega)
NZ (Nueva Zelanda)
PA (Panamá)
PE (Perú)
PH (Filipinas)
PL (Polonia)
PM (San Pedro y Miquelón)
PR (Puerto Rico)
PT (Portugal)
PY (Paraguay)
RE (Reunión)
RO (Rumania)
RS (Република Србија)
RU (Rusia)
RW (Rwanda)
SC (Seychelles)
SD (جمهورية السودان)
SE (Suecia)
SG (Singapur)
SH (Santa Elena)
SI (República de Eslovenia)
SJ (Svalbard y Jan Mayen)
SK (República Eslovaca)
SL (Sierra Leona)
SM (San Marino)
SN (República de Senegal)
SO (Jamhuuriyadda Federaalka Soomaaliya)
SR (Surinam)
SS (Sudán del Sur)
ST (São Tomé y Príncipe)
SV (El Salvador)
SX (Sint Maarten)
SZ (Eswatini)
TC (Islas Turcas y Caicos)
TD (جمهورية تشاد)
TG (República Togolesa)
TN (الجمهورية التونسية)
TO (Puleʻanga Fakatuʻi ʻo Tonga)
TR (Turquía)
TT (Trinidad y Tobago)
TW (中華民國)
TZ (Tanzania)
UA (Україна)
UG (Uganda)
US (Estados Unidos de América)
UY (Uruguay)
VA (Estado de la Ciudad del Vaticano)
VC (San Vicente y las Granadinas)
VE (Venezuela)
VG (Islas Vírgenes Británicas)
VI (Islas Vírgenes de los Estados Unidos)
VN (Cộng hòa Xã hội chủ nghĩa Việt Nam)
VU (República de Vanuatu)
XK (Republika e Kosovës)
YT (Mayotte)
ZA (Sudáfrica)
ZM (Zambia)
ZW (Zimbabue)
Esta API es ideal para aquellos que desean hacer un seguimiento de cualquier día festivo en el país de su elección. Podrás detectar cuántos días laborables tendrá el año y tomar decisiones basadas en esa información.
Si eres una agencia de viajes y deseas ofrecer ofertas especiales en base a un día festivo específico, puedes lograrlo con esta API.
Reconoce dónde se llevará a cabo el día festivo, para que sepas si es un día laborable o un día de fin de semana.
Aparte del número de llamadas a la API por mes:
Plan Gratis: 1 solicitud por segundo.
Plan Básico: 100 solicitudes por segundo.
Para usar este endpoint, solo ejecútalo y obtendrás todos los países disponibles.
{"message":"Available Countries","total":233,"countriesAvailable":["afghanistan","albania","algeria","american-samoa","andorra","angola","anguilla","antigua-and-barbuda","argentina","armenia","aruba","australia","austria","azerbaijan","bahrain","bangladesh","barbados","belarus","belgium","belize","benin","bermuda","bhutan","bolivia","bosnia","botswana","brazil","british-virgin-islands","brunei","bulgaria","burkina-faso","burundi","cape-verde","cambodia","cameroon","canada","cayman-islands","central-african-republic","chad","chile","china","colombia","comores","republic-of-the-congo","dr-congo","cook-islands","costa-rica","ivory-coast","croatia","cuba","curacao","cyprus","czech","denmark","djibouti","dominica","dominican-republic","timor-leste","ecuador","egypt","el-salvador","guineaecuatorial","eritrea","estonia","eswatini","ethiopia","falkland-islands","faroe-islands","fiji","finland","france","french-guiana","french-polynesia","gabon","gambia","georgia","germany","ghana","gibraltar","greece","greenland","grenada","guadeloupe","guam","guatemala","guernsey","guinea","guinea-bissau","guyana","haiti","honduras","hong-kong","hungary","iceland","india","indonesia","iran","iraq","ireland","isle-of-man","israel","italy","jamaica","japan","jersey","jordan","kazakhstan","kenya","kiribati","kosovo","kuwait","kyrgyzstan","laos","latvia","lebanon","lesotho","liberia","libya","liechtenstein","lithuania","luxembourg","macau","madagascar","malawi","malaysia","maldives","mali","malta","marshall-islands","martinique","mauritania","mauritius","mayotte","mexico","micronesia","moldova","monaco","mongolia","montenegro","montserrat","morocco","mozambique","myanmar","namibia","nauru","nepal","netherlands","new-caledonia","new-zealand","nicaragua","niger","nigeria","norfolk-island","north-korea","macedonia","northern-mariana-islands","norway","oman","pakistan","palau","panama","papua-new-guinea","paraguay","peru","philippines","poland","portugal","puerto-rico","qatar","reunion","romania","russia","rwanda","saint-helena","saint-kitts-and-nevis","saint-lucia","saint-martin","saint-pierre-and-miquelon","saint-vincent-and-the-grenadines","samoa","san-marino","sao-tome-and-principe","saudi-arabia","senegal","serbia","seychelles","sierra-leone","singapore","sint-maarten","slovakia","slovenia","solomon-islands","somalia","south-africa","south-korea","south-sudan","spain","sri-lanka","saint-barthelemy","sudan","suriname","sweden","switzerland","syria","taiwan","tajikistan","tanzania","thailand","bahamas","togo","tonga","trinidad","tunisia","turkey","turkmenistan","turks-and-caicos-islands","tuvalu","uganda","ukraine","united-arab-emirates","uk","us","uruguay","united-states-virgin-islands","uzbekistan","vanuatu","vatican-city-state","venezuela","vietnam","wallis-and-futuna","yemen","zambia","zimbabwe"]}
curl --location --request GET 'https://zylalabs.com/api/260/check+holidays+api/7772/available+countries' --header 'Authorization: Bearer YOUR_API_KEY'
Para utilizar este endpoint, debes ingresar un nombre de país y un año (opcional).
Días festivos por país - Características del Endpoint
| Objeto | Descripción |
|---|---|
country |
[Requerido] Indicates a country name |
year |
Opcional Indicates a year |
{"country":"denmark","year":2024,"holidays":[{"date":"Jan 1 - Monday","name":"New Year's Day","type":"National Holiday","details":""},{"date":"Jan 14 - Sunday","name":"Accession of King Frederik X","type":"Observance","details":""},{"date":"Feb 11 - Sunday","name":"Carnival","type":"Observance","details":""},{"date":"Feb 14 - Wednesday","name":"Valentine's Day","type":"Observance","details":""},{"date":"Mar 20 - Wednesday","name":"March Equinox","type":"Season","details":""},{"date":"Mar 24 - Sunday","name":"Palm Sunday","type":"Observance","details":""},{"date":"Mar 28 - Thursday","name":"Maundy Thursday","type":"National Holiday","details":""},{"date":"Mar 29 - Friday","name":"Good Friday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Easter Sunday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Daylight Saving Time starts","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Apr 1 - Monday","name":"Easter Monday","type":"National Holiday","details":""},{"date":"Apr 26 - Friday","name":"Great Prayer Day","type":"Observance","details":""},{"date":"May 1 - Wednesday","name":"Labor Day / May Day","type":"Private Sector Holiday","details":""},{"date":"May 5 - Sunday","name":"Liberation Day","type":"Observance","details":""},{"date":"May 9 - Thursday","name":"Ascension Day","type":"National Holiday","details":""},{"date":"May 12 - Sunday","name":"Mother’s Day","type":"Observance","details":""},{"date":"May 19 - Sunday","name":"Whit Sunday","type":"National Holiday","details":""},{"date":"May 20 - Monday","name":"Whit Monday","type":"National Holiday","details":""},{"date":"Jun 5 - Wednesday","name":"Father’s Day","type":"Observance","details":""},{"date":"Jun 5 - Wednesday","name":"Constitution Day","type":"Private Sector Holiday","details":""},{"date":"Jun 20 - Thursday","name":"June Solstice","type":"Season","details":""},{"date":"Sep 22 - Sunday","name":"September Equinox","type":"Season","details":""},{"date":"Oct 27 - Sunday","name":"Daylight Saving Time ends","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Oct 31 - Thursday","name":"Halloween","type":"Observance","details":""},{"date":"Dec 21 - Saturday","name":"December Solstice","type":"Season","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Observance","details":""},{"date":"Dec 25 - Wednesday","name":"Christmas Day","type":"National Holiday","details":""},{"date":"Dec 26 - Thursday","name":"2nd Christmas Day","type":"National Holiday","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Observance","details":""}]}
curl --location --request GET 'https://zylalabs.com/api/260/check+holidays+api/7773/holidays+by+country?country=Denmark&year=2024' --header 'Authorization: Bearer YOUR_API_KEY'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
El punto final "Obtener Festivos" devuelve una lista de festivos para un país y año específicos, incluyendo detalles como la fecha, el nombre, el tipo (público o no público) y el día de la semana. El punto final "Países Disponibles" proporciona una lista de todos los países admitidos. El punto final "Festivos por País" devuelve festivos para un país y año específicos, detallando la fecha, el nombre, el tipo y información adicional.
Los campos clave en los datos de respuesta incluyen "fecha" (fecha del feriado), "nombreLocal" (nombre en el idioma local), "nombre" (nombre del feriado), "tipo" (público o no público) y "códigoDePaís" (código ISO del país). Estos campos ayudan a identificar y categorizar cada feriado.
Los datos de respuesta están organizados en formato JSON, donde cada festividad se representa como un objeto dentro de un arreglo. Cada objeto contiene pares de clave-valor para atributos como fecha, nombre y tipo, lo que facilita su análisis y utilización de manera programática.
Los endpoints "Obtener Días Festivos" y "Días Festivos por País" requieren parámetros como "countryCode" (código ISO del país) y "year" (opcional). Los usuarios pueden personalizar las solicitudes especificando el mes y el día para obtener información más precisa sobre los días festivos.
El endpoint "Obtener Días Festivos" proporciona una lista completa de días festivos para un país y año especificados. El endpoint "Países Disponibles" enumera todos los países soportados por la API. El endpoint "Días Festivos por País" ofrece información detallada sobre días festivos para un país específico, incluyendo celebraciones y días festivos nacionales.
Los usuarios pueden utilizar los datos devueltos para planificar eventos, gestionar horarios de trabajo o crear itinerarios de viaje. Por ejemplo, al analizar el número de días festivos en un año, las empresas pueden evaluar los días operativos potenciales y ajustar la dotación de personal en consecuencia.
Los datos provienen de calendarios de días festivos oficiales del gobierno y bases de datos internacionales de renombre. Esto garantiza un alto nivel de precisión y fiabilidad en la información sobre días festivos proporcionada por la API.
Si una solicitud devuelve resultados parciales o vacíos, los usuarios deben verificar los parámetros utilizados, como el código de país y el año. Además, revisar la documentación de la API para los países admitidos y los rangos de fechas válidos puede ayudar a asegurar solicitudes precisas.
Nivel de Servicio:
100%
Tiempo de Respuesta:
157ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
451ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.366ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
454ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
299ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
353ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
270ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
97ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
434ms
Nivel de Servicio:
40%
Tiempo de Respuesta:
120ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.115ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
10.266ms
Nivel de Servicio:
40%
Tiempo de Respuesta:
370ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
134ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.241ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
650ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
219ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
24ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.109ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
19ms