Documentación

Retorna la lista de países soportados, su estado de disponibilidad y los endpoints disponibles para cada uno.

Ejemplo de respuesta

{
  "success": true,
  "data": [
    {
      "code": "CL",
      "name": "Chile",
      "status": "available",
      "years_covered": { "from": 2020, "to": 2030 },
      "endpoints": [
        "/v1/CL/holidays/{year}",
        "/v1/CL/holidays/{year}/{month}",
        "/v1/CL/is-business-day",
        "/v1/CL/next-holiday"
      ]
    }
  ],
  "meta": { "total": 11, "available": 11 }
}

Retorna todos los feriados del país indicado para el año indicado.

Parámetros de ruta

Ejemplo

GET /v1/UY/holidays/2026

{
  "success": true,
  "data": [
    { "date": "2026-01-01", "name": "Año Nuevo", "type": "national", "irrenunciable": true },
    { "date": "2026-01-06", "name": "Día de los Niños", "type": "national", "irrenunciable": false },
    ...
  ],
  "meta": { "country": "UY", "year": 2026, "total": 15 }
}

GET /v1/MX/holidays/2004

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "country": "MX", "year": 2004, "total": 8,
    "warning": {
      "code": "HISTORICAL_ACCURACY",
      "message": "Holiday data for MX before 2006 may not reflect historical legislation. Results are calculated using current rules.",
      "reliable_from": 2006
    }
  }
}

Ver tabla completa: Chile 2026, Colombia, Perú, Uruguay y más países →

Retorna los feriados del país indicado para un mes específico.

Parámetros de ruta

Ejemplo

GET /v1/PY/holidays/2026/5

{
  "success": true,
  "data": [
    { "date": "2026-05-01", "name": "Día de los Trabajadores", "type": "national" },
    { "date": "2026-05-14", "name": "Víspera de la Independencia Nacional", "type": "national" },
    { "date": "2026-05-15", "name": "Independencia Nacional", "type": "national" }
  ],
  "meta": { "country": "PY", "year": 2026, "month": 5, "total": 3 }
}

Indica si una fecha es día hábil, considerando fines de semana y feriados del país indicado. El parámetro region activa feriados subnacionales para CL y MX.

Query parameters

Regiones disponibles — Chile

Regiones disponibles — México

Ejemplos

GET /v1/CL/is-business-day?date=2026-09-18

{
  "success": true,
  "data": { "date": "2026-09-18", "is_business_day": false, "day_of_week": "Friday", "region": null },
  "meta": { "country": "CL", "total": 1 }
}

GET /v1/CL/is-business-day?date=2026-06-07&region=CL-AP

{
  "success": true,
  "data": { "date": "2026-06-07", "is_business_day": false, "day_of_week": "Sunday", "region": "CL-AP" },
  "meta": { "country": "CL", "total": 1 }
}

GET /v1/MX/is-business-day?date=2026-05-05&region=MX-JAL

{
  "success": true,
  "data": { "date": "2026-05-05", "is_business_day": false, "day_of_week": "Tuesday", "region": "MX-JAL" },
  "meta": { "country": "MX", "total": 1 }
}

GET /v1/UY/is-business-day?date=2026-01-06

{
  "success": true,
  "data": { "date": "2026-01-06", "is_business_day": false, "day_of_week": "Tuesday", "region": null },
  "meta": { "country": "UY", "total": 1 }
}

Ver días hábiles por mes: Chile 2026, Colombia, Uruguay y más países →

Verifica si múltiples fechas son días hábiles en una sola llamada. Ideal para validar rangos de fechas, generar calendarios internos o procesar lotes de vencimientos sin acumular N requests HTTP.

Request body (JSON)

Ejemplo

POST /v1/CL/is-business-day/batch
Content-Type: application/json

{
  "dates": ["2026-09-18", "2026-09-19", "2026-09-21"]
}

{
  "success": true,
  "data": [
    { "date": "2026-09-18", "is_business_day": false, "day_of_week": "Friday" },
    { "date": "2026-09-19", "is_business_day": false, "day_of_week": "Saturday" },
    { "date": "2026-09-21", "is_business_day": true,  "day_of_week": "Monday" }
  ],
  "meta": {
    "country": "CL",
    "total": 3,
    "business_days": 1,
    "non_business_days": 2,
    "requests_consumed": 3
  }
}

Retorna el próximo feriado a partir de una fecha. Si no se indica fecha, usa el día de hoy.

Query parameters

Ejemplo

GET /v1/PY/next-holiday?from=2026-03-14

{
  "success": true,
  "data": { "date": "2026-04-02", "name": "Jueves Santo", "type": "national", "days_until": 19 },
  "meta": { "country": "PY", "from": "2026-03-14", "total": 1 }
}

Ver próximos feriados: Chile, Colombia, Paraguay y más países →

Suma N días hábiles a una fecha. Útil para calcular fechas de entrega, vencimientos o deadlines reales.

GET /v1/CL/business-days/add?date=2026-09-18&days=5

{
  "success": true,
  "data": { "result_date": "2026-09-25" },
  "meta": { "country": "CL", "start_date": "2026-09-18", "business_days_added": 5 }
}

Resta N días hábiles a una fecha. Útil para calcular fechas límite hacia atrás desde un vencimiento.

GET /v1/CO/business-days/subtract?date=2026-12-31&days=3

{
  "success": true,
  "data": { "result_date": "2026-12-28" },
  "meta": { "country": "CO", "start_date": "2026-12-31", "business_days_subtracted": 3 }
}

Cuenta los días hábiles entre dos fechas, ambas inclusive. Útil para SLAs, cálculo de plazos contractuales o reportes de productividad. La respuesta incluye el desglose completo de días para que no necesites calcularlo tú.

GET /v1/CL/business-days/between?from=2026-01-01&to=2026-01-31&calendar=mi-empresa

{
  "success": true,
  "data": {
    "business_days": 17,
    "total_calendar_days": 31,
    "holidays": 2,
    "custom_non_working": 2,
    "weekends": 10
  },
  "meta": {
    "country": "CL",
    "from": "2026-01-01",
    "to": "2026-01-31",
    "calendar": "mi-empresa",
    "quota_units_consumed": 31
  }
}

Retorna el último día hábil del mes de la fecha indicada. Útil para cierres contables, cortes de facturación y liquidaciones.

GET /v1/UY/last-business-day?date=2026-01-15

{
  "success": true,
  "data": { "last_business_day": "2026-01-30" },
  "meta": { "country": "UY", "month": "2026-01" }
}

Crea un nuevo calendario personalizado. El slug debe ser único para tu cuenta y solo puede contener letras, números y guiones.

curl -X POST https://api.feriados.io/v1/calendars \
  -H "Authorization: Bearer frd_tu_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Planta Norte","slug":"planta-norte"}'

{
  "success": true,
  "data": {
    "id": "01HZ...",
    "name": "Planta Norte",
    "slug": "planta-norte",
    "created_at": "2026-04-04T12:00:00.000Z"
  }
}

Retorna el consumo de requests del período de facturación actual: total usado, límite del plan y fecha de reset. Útil para monitorear cuota sin depender de los headers de respuesta.

curl https://api.feriados.io/v1/usage \
  -H "Authorization: Bearer frd_tu_key"

{
  "success": true,
  "data": {
    "plan": "starter",
    "requests_used": 1240,
    "requests_limit": 50000,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}