Llistar tots els tancaments mensuals de registre de jornada

Llista els tancaments mensuals del registre de jornada de la teva empresa amb paginació per cursor, ordenats per període descendent.

Admet filtrar per year.
Cada element exposa el seu estat (closed/reopened), els límits del període i el nombre d'empleats.

Paràmetres de consulta

per_page?integer

Mida de pàgina. Àlies de limit (enter entre 1 i 100, per defecte 25).

Predeterminat25

Rang1 <= value <= 100

limit?integer

Mida de pàgina. Enter entre 1 i 100. Per defecte 25. Àlies de per_page; si s'envien tots dos, guanya limit.

Predeterminat25

Rang1 <= value <= 100

cursor?string

Cursor de paginació opac. NO ESTÀNDARD en aquesta API: a diferència dels llistats per cursor (starting_after/ending_before), aquest endpoint embolcalla una paginació per offset, així que el cursor codifica el número de la pàgina següent. Utilitza el valor next_cursor retornat per la pàgina anterior.

year?integer

Filtra els tancaments mensuals per any natural.

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/monthly-time-record-closes?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": "01933a40-04a9-73b5-9bc2-9c0d1e2f3a01",
      "object": "monthly_time_record_close",
      "year": 2026,
      "month": 4,
      "status": "closed",
      "period_start": "2026-04-01",
      "period_end": "2026-04-30",
      "closed_by_id": "01933a1f-8c21-7b3d-9e4f-1a2b3c4d5ecc",
      "closed_at": "2026-05-02T08:00:00Z",
      "reopened_by_id": null,
      "reopened_at": null,
      "employee_count": 12,
      "is_sealed": true
    }
  ],
  "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_408646f214e3c6beaa4c5254ca"
  }
}

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

{
  "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_d5258c903c9b12b9ecddaa61bc"
  }
}

{
  "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_680bcb22c992aa02412fb0b312"
  }
}

Llistar tots els tancaments mensuals de registre de jornada

Authorization

Paràmetres de consulta

Headers

Cos de la resposta

200application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`