API JSON pública del Calendario Laboral — México (v1)

Esta API expone los calendarios laborales de México en formato JSON. Incluye los días de descanso obligatorio establecidos por el artículo 74 de la Ley Federal del Trabajo (LFT), el calendario fiscal del SAT y el calendario escolar de la SEP. Todas las rutas empiezan por /mx/v1/{año}/... y devuelven archivos JSON estáticos servidos desde CDN, sin necesidad de autenticación.

Los días de descanso obligatorio se calculan algorítmicamente a partir de la LFT art. 74, incluyendo los tres festivos móviles que se celebran en lunes (Constitución, Natalicio de Juárez y Revolución). Los datos están disponibles para cualquier año sin depender de publicaciones externas.

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

Los datos provienen de fuentes públicas oficiales de México (LFT, SAT, SEP). Este servicio es informativo y no constituye asesoramiento legal o fiscal. También puedes usar la calculadora de días laborables para cálculos interactivos.

Endpoints disponibles

• /mx/v1/{año}/nacionales.json — Festivos nacionales
• /mx/v1/{año}/estados.json — Estados (listado)
• /mx/v1/{año}/estados/{estado}.json — Festivos de un estado
• /mx/v1/{año}/estados/{estado}/{municipio}.json — Festivos de un municipio
• /mx/v1/{año}/fiscal.json — Calendario fiscal SAT completo
• /mx/v1/{año}/fiscal/{perfil}.json — Fiscal por perfil (personas-fisicas, personas-morales, resico)
• /mx/v1/{año}/escolar.json — Calendarios escolares por estado
• /mx/v1/{año}/escolar/{estado}.json — Calendario escolar detallado de un estado

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

Respuesta del endpoint /mx/v1/2026/nacionales.json:

{
  "year": 2026,
  "calendarType": "laboral",
  "country": "MX",
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "Año Nuevo",
      "type": "national",
      "scope": "national"
    },
    {
      "date": "2026-05-01",
      "name": "Día del Trabajo",
      "type": "national",
      "scope": "national"
    }
  ],
  "stats": {
    "totalHolidays": 7,
    "nationalHolidays": 7
  },
  "disclaimer": "Datos informativos..."
}

Se muestran solo 2 festivos como ejemplo. La respuesta real incluye los 7 días de descanso obligatorio del año.

Campos de la respuesta

Casos de uso

• Nóminas y RRHH: integra los días de descanso obligatorio en tu sistema de nómina para calcular días laborables y vacaciones automáticamente.
• Plazos fiscales SAT: combina el endpoint fiscal con el laboral para calcular vencimientos de declaraciones mensuales, anuales o pagos provisionales.
• Planificación de proyectos: alimenta herramientas de gestión (Jira, Asana, Monday) con los festivos mexicanos para estimar entregas.
• Dashboards y BI: descarga el JSON para generar reportes de productividad o análisis de capacidad por estado.
• Apps móviles y chatbots: consulta los endpoints desde cualquier plataforma para mostrar festivos o calcular días hábiles.

Ejemplos para 2026

/mx/v1/2026/nacionales.json
/mx/v1/2026/estados.json
/mx/v1/2026/estados/aguascalientes.json
/mx/v1/2026/estados/aguascalientes/aguascalientes-capital.json
/mx/v1/2026/fiscal.json
/mx/v1/2026/fiscal/personas-fisicas.json
/mx/v1/2026/escolar.json
/mx/v1/2026/escolar/ciudad-de-mexico.json

Uso web equivalente: calendario laboral 2026 | calculadora de días laborables.