Logo
Iniciar sesiónComenzar
Public Holidays API
EventosMANTENIDA1 token / llamada

Public Holidays API

23.786 festivos de 204 países de 2020 a 2028, con ámbito regional y puentes

Feriados publicos de 204 paises y territorios, servidos desde nuestra propia base de datos — 23.786 feriados de 2020 a 2028, con datos del proyecto Nager.Date (MIT). Cada feriado lleva su nombre en ingles y local, alcance nacional o regional (con codigos de subdivision ISO), marca de fecha fija y tipos (Public, Bank, Observance...). Pide el ano completo de un pais (EE.UU. 2026 muestra correctamente el Dia de la Independencia observado el viernes 3 de julio), pregunta si una fecha es feriado (/holidays/today — 178 paises celebran el 25 de diciembre), consulta los proximos feriados de cualquier pais, o solicita los fines de semana largos calculados (EE.UU. 2026 tiene 8). La ruta original /v1/{year}/{code} sigue funcionando sin cambios, asi que las integraciones existentes no se rompen — pero las respuestas ahora salen de D1 en milisegundos con historial multianual en vez de un proxy a terceros. Herramientas de RR.HH. y nomina, calculadoras de fechas de entrega, sistemas de reservas y calendarios de marketing.

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 1 token por llamada, así que el plan gratuito cubre unas 500 llamadas al mes.

Start free — 500 tokens / mo →See all plans
Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras
response.json
{
  "query": "GET /v1/holidays/today?country=US&date=2026-07-03",
  "is_public_holiday": true,
  "holiday": "Independence Day (observed)",
  "coverage": "204 countries, 2020-2028",
  "long_weekends": "computed per country/year"
}

Also available on

RapidApi
RapidApi
Listo para producción
Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla
REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs
Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de Public Holidays API

  • Omitir festivos al calcular fechas de entrega, SLA o vencimientos de pago por país.

  • Mostrar los próximos festivos y puentes en una app de RR. HH., viajes o planificación.

  • Comprobar si una fecha es festivo antes de enviar notificaciones o abrir una tienda.

  • Gestionar correctamente los festivos regionales con los códigos de subdivisión ISO de cada entrada.

Endpoints de Public Holidays API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

GETCountry Holidays By Year

https://public-holidays.dataandapis.com/v1/holidays/{country}/{year}

Parámetros de ruta

ParámetroEjemplo
countryUSObligatorio
year2026Obligatorio

Petición de ejemplo

curl "https://public-holidays.dataandapis.com/v1/holidays/US/2026" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
[
  {
    "date": "2026-01-01",
    "localName": "New Year's Day",
    "name": "New Year's Day",
    "countryCode": "US",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public",
      "Bank"
    ]
  },
  {
    "date": "2026-01-19",
    "localName": "Martin Luther King, Jr. Day",
    "name": "Martin Luther King, Jr. Day",
    "countryCode": "US",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public",
      "Bank"
    ]
…
Ver la respuesta completa
[
  {
    "date": "2026-01-01",
    "localName": "New Year's Day",
    "name": "New Year's Day",
    "countryCode": "US",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public",
      "Bank"
    ]
  },
  {
    "date": "2026-01-19",
    "localName": "Martin Luther King, Jr. Day",
    "name": "Martin Luther King, Jr. Day",
    "countryCode": "US",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public",
      "Bank"
    ]
  },
  {
    "date": "2026-02-12",
    "localName": "Lincoln's Birthday",
    "name": "Lincoln's Birthday",
    "countryCode": "US",
    "fixed": false,
    "global": false,
    "counties": [
      "US-CA",
      "US-CT",
      "US-IL",
      "US-IN",
      "US-KY",
      "US-MI",
      "US-NY",
      "US-MO",
      "US-OH"
    ],
    "launchYear": null,
    "types": [
      "Observance"
    ]
  }
]

GETData Sources

https://public-holidays.dataandapis.com/v1/sources

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://public-holidays.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "sources": [
    {
      "slug": "nager-date",
      "name": "Nager.Date worldwide public holidays",
      "publisher": "Nager.Date project (Tino Hager and contributors)",
      "licence": "MIT",
      "source_url": "https://date.nager.at/",
      "file_url": "https://date.nager.at/api/v3/PublicHolidays",
      "cadence": "years 2020-2028; annual re-scrape adds the next year",
      "record_count": 23786,
      "retrieved_at": "2026-09-06"
    }
  ]
}

GETIs It A Holiday

https://public-holidays.dataandapis.com/v1/holidays/today

Parámetros de consulta

ParámetroEjemplo
countryUSOpcional
date2026-07-03Opcional

Petición de ejemplo

curl "https://public-holidays.dataandapis.com/v1/holidays/today?country=US&date=2026-07-03" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "country": "US",
  "date": "2026-07-03",
  "is_public_holiday": true,
  "holidays": [
    {
      "date": "2026-07-03",
      "localName": "Independence Day",
      "name": "Independence Day",
      "countryCode": "US",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
        "Public",
        "Bank"
      ]
    }
  ]
}

GETLong Weekends

https://public-holidays.dataandapis.com/v1/holidays/long-weekends/{country}/{year}

Parámetros de ruta

ParámetroEjemplo
countryUSObligatorio
year2026Obligatorio

Petición de ejemplo

curl "https://public-holidays.dataandapis.com/v1/holidays/long-weekends/US/2026" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "country": "US",
  "year": 2026,
  "long_weekends": [
    {
      "start": "2026-01-17",
      "end": "2026-01-19",
      "days": 3,
      "holidays": [
        "Martin Luther King, Jr. Day"
      ]
    },
    {
      "start": "2026-02-14",
      "end": "2026-02-16",
      "days": 3,
      "holidays": [
        "Presidents Day"
      ]
    },
    {
      "start": "2026-05-23",
      "end": "2026-05-25",
      "days": 3,
      "holidays": [
        "Memorial Day"
      ]
…
Ver la respuesta completa
{
  "ok": true,
  "country": "US",
  "year": 2026,
  "long_weekends": [
    {
      "start": "2026-01-17",
      "end": "2026-01-19",
      "days": 3,
      "holidays": [
        "Martin Luther King, Jr. Day"
      ]
    },
    {
      "start": "2026-02-14",
      "end": "2026-02-16",
      "days": 3,
      "holidays": [
        "Presidents Day"
      ]
    },
    {
      "start": "2026-05-23",
      "end": "2026-05-25",
      "days": 3,
      "holidays": [
        "Memorial Day"
      ]
    }
  ]
}

GETNext Holidays

https://public-holidays.dataandapis.com/v1/holidays/next

Parámetros de consulta

ParámetroEjemplo
count5Opcional
countryMXObligatorio

Petición de ejemplo

curl "https://public-holidays.dataandapis.com/v1/holidays/next?count=5&country=MX" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "country": "MX",
  "from": "2026-09-06",
  "holidays": [
    {
      "date": "2026-09-16",
      "localName": "Día de la Independencia",
      "name": "Independence Day",
      "countryCode": "MX",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
        "Public"
      ]
    },
    {
      "date": "2026-11-16",
      "localName": "Día de la Revolución",
      "name": "Revolution Day",
      "countryCode": "MX",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
…
Ver la respuesta completa
{
  "ok": true,
  "country": "MX",
  "from": "2026-09-06",
  "holidays": [
    {
      "date": "2026-09-16",
      "localName": "Día de la Independencia",
      "name": "Independence Day",
      "countryCode": "MX",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
        "Public"
      ]
    },
    {
      "date": "2026-11-16",
      "localName": "Día de la Revolución",
      "name": "Revolution Day",
      "countryCode": "MX",
      "fixed": false,
      "global": true,
      "counties": null,
      "launchYear": null,
      "types": [
        "Public"
      ]
    }
  ]
}

GETSupported Countries

https://public-holidays.dataandapis.com/v1/countries

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://public-holidays.dataandapis.com/v1/countries" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "total": 204,
  "countries": [
    {
      "code": "AD",
      "name": "Andorra",
      "years_from": 2020,
      "years_to": 2028,
      "holiday_count": 126
    },
    {
      "code": "AL",
      "name": "Albania",
      "years_from": 2020,
      "years_to": 2028,
      "holiday_count": 119
    }
  ]
}

De dónde salen los datos

Fuente
Datos de festivos de Nager.Date (licencia MIT), cargados en la propia base de datos de la API.
Actualización
Carga anual que añade el año siguiente; disponible de 2020 a 2028.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes
6endpoints
RESTarquitectura
1clave para todas las APIs
  • Respuestas totalmente tipadas — autocompletado en tu IDE
  • Sigue la API al día — los nuevos endpoints llegan el mismo día
  • Una sola clave funciona en más de 125 APIs de la plataforma
import axios from 'axios';

const { data } = await axios.get(
  'https://public-holidays.dataandapis.com/v1/holidays/{country}/{year}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Public Holidays API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key

Parámetros de ruta

country
year
import axios from 'axios';

const url = 'https://public-holidays.dataandapis.com/v1/holidays/{country}/{year}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte comunitario
Comienza gratis
Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email
Suscribirse

PRO

$24.99/mes

100.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email prioritario
Suscribirse

ULTRA

$99.99/mes

1.000.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte prioritario
Suscribirse

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

Preguntas sobre Public Holidays API

APIs que suelen usarse con Public Holidays API

Lanza Public Holidays API esta tarde.

500 tokens gratis. Sin tarjeta. Y más de 125 APIs más con la misma clave.

Obtén tu clave API →Explorar todas las APIs