Listar festivos

GET /api/v1/holidays

Devuelve el calendario de festivos de una sede (por su id), del más antiguo al más reciente. Cada festivo trae su fecha, nombre y tipo (nacional, autonómico o local). El parámetro `work_center_id` es obligatorio (el calendario es por sede); puedes acotar por `year`. La respuesta se pagina e incluye un objeto meta.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
`work_center_id`	string	Sí	Id de la sede cuyo calendario quieres. Descúbrelo con "Listar sedes".
`year`	string	No	Acota a un año (YYYY). Omítelo para todo el calendario.
`page`	integer	No	Página (desde 1).
`page_size`	integer	No	Festivos por página (máx. 100).

Ejemplo

Sustituye db_live_tu_clave por tu clave.

curl -s -H "Authorization: Bearer db_live_tu_clave" \
  "https://api.dutybeat.com/api/v1/holidays?work_center_id=wc-madrid&year=2026&page_size=3" | jq

from dutybeat import DutyBeat

client = DutyBeat(api_key="db_live_tu_clave")

page = client.holidays.list("wc-madrid", year="2026", page_size=3)
for h in page:
    print(h.date, h.type, h.name)
print("total:", page.total)

Connect-DutyBeat -ApiKey 'db_live_tu_clave'

$res = Get-DbHoliday -WorkCenterId 'wc-madrid' -Year '2026' -PageSize 3
$res.data | ForEach-Object { '{0}  {1}  {2}' -f $_.date, $_.type, $_.name }
'total: {0}' -f $res.meta.total

Respuesta de ejemplo

Lo que imprime cada snippet al ejecutarlo: cURL devuelve el JSON crudo; los snippets de Python y PowerShell piden campos concretos, así que su salida es la de cada uno.

{
  "data": [
    {
      "date": "2026-01-01",
      "name": "Año Nuevo",
      "type": "national"
    },
    {
      "date": "2026-01-06",
      "name": "Epifanía del Señor",
      "type": "national"
    },
    {
      "date": "2026-04-03",
      "name": "Viernes Santo",
      "type": "national"
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 3,
    "total": 12
  }
}

2026-01-01 national Año Nuevo
2026-01-06 national Epifanía del Señor
2026-04-03 national Viernes Santo
total: 12

2026-01-01  national  Año Nuevo
2026-01-06  national  Epifanía del Señor
2026-04-03  national  Viernes Santo
total: 12

Listar festivos

Parámetros de consulta

Ejemplo

Respuesta de ejemplo

Prueba la demo

Tu demo está lista

Política de Privacidad