Calendario de festivos — API de festivos Online
Festivos públicos, bancarios, regionales, religiosos y conmemorativos de 51 países (Europa + Golfo) y sus regiones, 2020-2035, generados por nuestro propio motor de reglas de festivos. Cada festivo indica si es día no laborable, festivo bancario o si cae dentro de las vacaciones escolares, si un festivo en fin de semana se trasladó a otro día, si su fecha aún es estimada (calendario islámico) y si ese día se aplica una prohibición de circulación de camiones y en qué horario. Incluye la norma de la ley marcial de Ucrania (festivos listados, no días libres) y los traslados de días por decreto (transfers[]). Hasta 10 países por llamada; un año o cualquier rango de hasta 731 días.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
country | Código de país ISO-2, o lista separada por comas de hasta 10 (obligatorio), p. ej. DE o DE,PL,UA |
year | YYYY, 2020-2035 (por defecto: año actual). Se ignora si se envía from/to |
from | Inicio del rango YYYY-MM-DD (con to; máximo 731 días) |
to | Fin del rango YYYY-MM-DD |
region | Región ISO 3166-2, p. ej. DE-BY (o BY con un solo país): festivos nacionales + solo los de esa región. Omitir para todas las regiones |
type | Filtro separado por comas: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, o all. Por defecto: todo excepto BRIDGE |
lang | Códigos de idioma separados por comas para name.translations (por defecto: todos los idiomas disponibles), p. ej. en,uk,pl |
q | Búsqueda en los nombres de festivos (cualquier idioma), p. ej. christmas |
id | Un festivo por id (se ignoran los demás filtros) |
school | 1 = incluye también los periodos de vacaciones escolares (school_holidays[]) de los países que los publican |
include | impact = añade business_intelligence a cada festivo (Pro y superiores) |
min_impact | Solo festivos con un impact_score igual o superior a este valor (0-100); implica include=impact |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
data.holidays[].id | ID estable del festivo, p. ej. hol_de_christmas_day_2026 — el valor que acepta ?id=. Los días observados (trasladados) terminan en _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=lunes..7=domingo), day_name, is_weekend (fin de semana del país). |
data.holidays[].name | en, local (en local_lang) y translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL o REGIONAL, regions_affected (códigos ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (fecha calculada del calendario islámico), note (suspended_martial_law, transferred_by_decree o null). |
data.holidays[].floating_logic | is_floating, rule (regla de la fecha en lenguaje natural), shifted_from (fecha original cuando un festivo en fin de semana se trasladó). |
data.holidays[].truck_ban | Prohibición de circulación de camiones en festivos en ese país: applies, time_from, time_until (hora local), min_weight_tons, eve_rule {date,time_from,time_until} para una prohibición en la víspera, scope_note. |
data.holidays[].business_intelligence | Con include=impact en Pro y superiores: el mismo bloque estimado por modelo que devuelve el producto de impacto. |
data.transfers[] | Traslados de días por decreto en la ventana: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Con school=1: id, start_date, end_date, name, location. |
data.count | Festivos devueltos; countries y window {from,to} reflejan la solicitud. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Actualizado