v2

latestOpenAPI 3.0.3CC-BY-4.02026-07-262256119.8 KB

Fiscal

Consultar si una fecha es día hábil

Devuelve si una fecha es día hábil bajo el calendario estatal de días inhábiles (sábados, domingos y festivos nacionales; art. 30 Ley 39/2015) y, si no lo es, el siguiente día hábil. Endpoint público (sin autenticación), sin efectos colaterales. Sin fecha, usa hoy (UTC).

get/dias-habiles

Query parameters

fechastring

Example:2026-04-18

Fecha a consultar en formato YYYY-MM-DD. Por defecto, hoy (UTC).

Response

Resultado de la consulta de día hábil

fechastring date required

Fecha consultada (YYYY-MM-DD).

es_habilboolean required

Si la fecha es día hábil.

motivostring nullable required

Motivo por el que la fecha es inhábil: 'sábado', 'domingo', o el nombre del festivo nacional. Null cuando es_habil es true.

siguiente_habilstring date nullable required

Siguiente día hábil (YYYY-MM-DD) cuando la fecha consultada es inhábil. Null cuando es_habil es true.

fuentestring required

Referencia normativa del calendario de días inhábiles.

coberturastring required

Años cubiertos por el calendario nacional de días inhábiles.

Example response

{
  "fecha": "2026-04-18",
  "motivo": "sábado",
  "siguiente_habil": "2026-04-20",
  "fuente": "BOE-A-2025-23702 (art. 30 Ley 39/2015)",
  "cobertura": "calendario estatal 2026 (BOE-A-2025-23702)"
}