Llistar tots els festius

Llista els festius visibles per a la teva empresa amb paginació per cursor: festius de referència globals (nacionals i per comunitat autònoma, precarregats i de només lectura) més els teus festius locals personalitzats.

Admet filtrar per year, ccaa (comunitat autònoma ISO 3166-2:ES), scope (national/autonomic/local) i source (reference per a files precarregades, custom per a les pròpies).

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de consulta

limit?integer

Nombre d'objectes a retornar. Enter entre 1 i 100. Per defecte 25.

Predeterminat25

Rang1 <= value <= 100

starting_after?string

Cursor per a paginació cap endavant. Fes servir l'uuid de l'últim objecte de la pàgina anterior.

Formatuuid

ending_before?string

Cursor per a paginació cap enrere. Fes servir l'uuid del primer objecte de la pàgina actual.

Formatuuid

year?integer

Any natural del festiu. Coincidència exacta amb year.

ccaa?string

Codi de comunitat autònoma espanyola (ISO 3166-2:ES) — coincideix amb els festius autonòmics d'aquella comunitat. Coincidència exacta amb ccaa.

ccaa[in]?string

Codi de comunitat autònoma espanyola (ISO 3166-2:ES) — coincideix amb els festius autonòmics d'aquella comunitat. Llista separada per comes. Coincideix qualsevol dels valors.

scope?string

Àmbit territorial del festiu. Coincidència exacta amb scope.

Valor a"national" | "autonomic" | "local"

scope[in]?string

Àmbit territorial del festiu. Llista separada per comes. Coincideix qualsevol dels valors.

source?string

Origen del festiu: reference (nacional/autonòmic sembrat) o custom (local definit per l'empresa). Coincidència exacta amb source.

Valor a"reference" | "custom"

Headers

Factuarea-Version?string

Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.

Formatdate

X-Active-Profile?string

Opera en nom d'una empresa filla (API key mestra de gestoria): passa el seu id públic (UUID v7) i la petició s'executa contra les dades d'aquella filla sense canviar l'scope, el tier ni l'environment de la clau (omet-lo per usar la pròpia empresa de la clau). UUID no vàlid → 400 parameter_invalid_uuid; id desconegut o no propi → 404 profile_not_found. Consulta la guia d'Acting on behalf.

Formatuuid

Cos de la resposta

`application/json`

Exemple de petició

const apiKey = process.env.FACTUAREA_API_KEY;if (!apiKey) throw new Error("Set FACTUAREA_API_KEY");const response = await fetch("https://api.factuarea.com/v1/holidays?limit=25", {  method: "GET",  headers: { Authorization: `Bearer ${apiKey}`, ...{"Accept":"application/json"} },});if (!response.ok) throw new Error(await response.text());if (response.status !== 204) console.log(await response.json());

Exemple de resposta

{
  "data": [
    {
      "id": "01933a60-37dc-76e8-8ef5-cf3a4b5c6d01",
      "object": "holiday",
      "scope": "autonomic",
      "community_code": "AN",
      "date": "2026-02-28",
      "year": 2026,
      "name": "Día de Andalucía",
      "is_system": true,
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "Falta header Authorization o X-API-Key.",
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_1e843c4551932048d03a95182c"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta operación requiere el scope 'holidays:read'. Tu API key solo tiene los scopes: ninguno.",
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_a5daf6b14797eca9c41bd5cd0e"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_param_value",
    "message": "Los parámetros 'starting_after' y 'ending_before' son mutuamente excluyentes.",
    "doc_url": "https://docs.factuarea.com/guides/errors#invalid_param_value",
    "request_id": "req_a48e997fb46697666d55a0ac82"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el límite de requests permitido. Reintenta más tarde.",
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_6bc1988258bbc91f178eaf16f4"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Algo se rompió en nuestro lado al procesar la petición. La condición no la provoca tu payload.",
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_71afe1a76dc82b5777e6a4c00c"
  }
}

Llistar tots els festius

Authorization

Paràmetres de consulta

Headers

Cos de la resposta

200application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`