API JSON pública del Calendario Laboral — Argentina (v1)

Esta API expone los calendarios laborales de Argentina en formato JSON. Todas las rutas empiezan por /ar/v1/{año}/.... Podés consumirla desde cualquier lenguaje (JavaScript, Python, PHP, etc.) con una simple petición HTTP GET. No requiere registro ni clave de acceso.

Los datos incluyen los feriados nacionales (inamovibles, trasladables, días no laborables y feriados puente), el calendario fiscal de AFIP/ARCA por perfil impositivo, y los calendarios escolares por provincia. Cada respuesta contiene metadatos como calendarType, year y disclaimer para facilitar la integración en sistemas de RRHH, ERPs, aplicaciones móviles y automatizaciones.

Años disponibles: 2025, 2026, 2027. Listado completo: 2025, 2026, 2027.

Los datos provienen de fuentes públicas del gobierno de Argentina (Boletín Oficial, AFIP/ARCA). Este servicio es informativo y no constituye asesoramiento legal o fiscal.

Endpoints disponibles

Todas las respuestas incluyen calendarType para identificar si el calendario es laboral, fiscal o escolar, y un campo disclaimer indicando que esta API no sustituye a fuentes oficiales.

El uso de la API exige atribución con enlace visible y no permite abuso de sincronizaciones.

Ejemplo de respuesta JSON

Así luce una respuesta típica del endpoint /ar/v1/2026/nacionales.json:

{
  "calendarType": "laboral",
  "year": 2026,
  "country": "AR",
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "Año Nuevo",
      "type": "inamovible",
      "scope": "nacional"
    },
    {
      "date": "2026-05-25",
      "name": "Día de la Revolución de Mayo",
      "type": "inamovible",
      "scope": "nacional"
    }
  ],
  "disclaimer": "Datos informativos..."
}

Campos de cada feriado

Campo Tipo Descripción
date string Fecha en formato ISO 8601 (YYYY-MM-DD)
name string Nombre oficial del feriado
type string inamovible, trasladable, no-laborable o puente
scope string nacional, provincial o municipal

Casos de uso

Ejemplos para 2026

/ar/v1/2026/nacionales.json
/ar/v1/2026/provincias.json
/ar/v1/2026/provincias/buenos-aires.json
/ar/v1/2026/provincias/buenos-aires/la-plata.json
/ar/v1/2026/fiscal.json
/ar/v1/2026/fiscal/monotributistas.json
/ar/v1/2026/escolar.json

Uso web equivalente: calendario laboral 2026.

Preguntas frecuentes

¿Necesito registrarme para usar la API?

No. La API es pública y no requiere registro ni clave de acceso. Solo se exige atribución con enlace visible a calendariosnacionales.com.

¿Qué formato devuelve la API?

Todas las respuestas son JSON con Content-Type: application/json. Cada feriado incluye campos como date, name, type y scope para facilitar la integración.

¿Incluye feriados provinciales?

Sí. El endpoint de provincia (/ar/v1/{año}/provincias/{provincia}.json) devuelve los feriados nacionales más los provinciales específicos. El endpoint de municipio agrega además los feriados locales.

¿Puedo usar la API en aplicaciones comerciales?

Sí, siempre que incluyas atribución con enlace visible. No se permite abuso de sincronizaciones ni redistribución masiva de los datos.

¿Cada cuánto se actualizan los datos?

Los feriados se actualizan cada vez que el Poder Ejecutivo Nacional publica un decreto en el Boletín Oficial. Los datos fiscales se actualizan según el calendario de AFIP/ARCA. Los calendarios escolares se actualizan al inicio de cada ciclo lectivo.