Listar elementos de la agenda

Devuelve una agenda combinada entre from y to (como máximo 93 días, ambos incluidos): tareas con vencimiento y, de otros módulos, vencimientos de facturas y de gastos, caducidades de presupuestos y proformas, ejecuciones de facturas recurrentes, plazos fiscales, ausencias y festivos.

sources elige las capas.
Cada capa exige además el scope de lectura de su propio recurso y su módulo (por ejemplo invoices:read para los vencimientos de facturas, absences:read para las ausencias); las capas que la clave no puede leer se omiten sin error, y sources en la respuesta lista las capas realmente servidas.
assignee_id (me o el id de un miembro) filtra la capa de tareas.
Toda la ventana se devuelve en una sola página.

Authorization

AuthorizationBearer <token>

En: header

Parámetros de consulta

from*string

Primer día de la ventana (YYYY-MM-DD, incluido). Obligatorio.

Formatodate

to*string

Último día de la ventana (YYYY-MM-DD, incluido). Obligatorio. La ventana abarca como máximo 93 días: una ventana más larga o invertida devuelve 400 parameter_invalid_range en to.

Formatodate

sources?string

Capas que se incluyen, separadas por comas: tasks, invoice_due, purchase_invoice_due, quote_expiry, proforma_expiry, recurring_invoice_run, fiscal_deadline, absence, holiday. Omítelo para incluir todas las capas; un valor vacío no incluye ninguna. Cada capa exige además el scope de lectura de su recurso (por ejemplo invoices:read para invoice_due) y su módulo: las capas que la clave no puede leer se omiten sin error, y sources en la respuesta lista solo las capas realmente servidas. Una capa desconocida devuelve 400 parameter_invalid_enum.

assignee_id?|

Solo filtra la capa tasks: me para el miembro titular de la API key, o el UUID de un miembro de tu empresa. Cualquier otro valor devuelve 422 invalid_param_value.

Headers

Factuarea-Version?string

Fija la versión de la API (YYYY-MM-DD, versionado por fecha estilo Stripe) para esta petición; omítelo para usar la versión fijada de la clave, o la última si no hay ninguna. Versión no soportada → 400 unsupported_api_version; malformada → 400 parameter_invalid_format. La versión efectiva se refleja en la cabecera de respuesta Factuarea-Version. Consulta la guía de Versioning.

Formatodate

X-Active-Profile?string

Opera en nombre de una empresa hija (API key maestra de gestoría): pasa su id público (UUID v7) y la petición se ejecuta contra los datos de esa hija sin cambiar el scope, el tier ni el environment de la clave (omítelo para usar la propia empresa de la clave). UUID inválido → 400 parameter_invalid_uuid; id desconocido o no propio → 404 profile_not_found. Consulta la guía de Acting on behalf.

Formatouuid

Cuerpo de la respuesta

`application/json`

Ejemplo de petición

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/agenda?from=2026-03-15&to=2026-03-15", {  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());

Ejemplo de respuesta

{
  "data": [
    {
      "id": "0193a4f2-8f53-7d44-8e85-7a9b1c3d5f12",
      "object": "agenda_item",
      "type": "tasks",
      "title": "Integrar la pasarela de pago en el checkout",
      "starts_on": "2026-09-21",
      "ends_on": "2026-10-06",
      "status": "active",
      "url": "/tasks/t/0193a4f2-8f53-7d44-8e85-7a9b1c3d5f12",
      "task": {
        "key": "DEV-12",
        "project_id": "0193a4f2-7c20-7a11-8b52-4d6e8f0a2c01",
        "project_name": "Desarrollo web",
        "priority": "high",
        "assignee_id": "0193a4f2-6b1c-7d3e-8a41-2c5e7f9a1b01",
        "board_status": "active",
        "completed": false
      },
      "fiscal": null
    },
    {
      "id": "0193a4f2-d40e-7cff-8d90-8f0a2b4c6e10",
      "object": "agenda_item",
      "type": "invoice_due",
      "title": "FAC-2026-00057 · Acme Soluciones SL",
      "starts_on": "2026-10-15",
      "ends_on": "2026-10-15",
      "status": "issued",
      "url": "/sales-invoices/0193a4f2-d40e-7cff-8d90-8f0a2b4c6e10",
      "task": null,
      "fiscal": null
    },
    {
      "id": "fiscal:303:2026-Q3",
      "object": "agenda_item",
      "type": "fiscal_deadline",
      "title": "Modelo 303 · 3T 2026",
      "starts_on": "2026-10-20",
      "ends_on": "2026-10-20",
      "status": "pending",
      "url": "/settings/tax-reports",
      "task": null,
      "fiscal": {
        "model": "303",
        "period": "2026-Q3",
        "task_id": "0193a4f2-8f53-7d44-8e85-7a9b1c3d5f30"
      }
    },
    {
      "id": "0193a4f2-d40e-7cff-8d90-8f0a2b4c6e01",
      "object": "agenda_item",
      "type": "absence",
      "title": "Lucía Fernández · Vacaciones",
      "starts_on": "2026-10-26",
      "ends_on": "2026-10-30",
      "status": "approved",
      "url": "/absence-calendar",
      "task": null,
      "fiscal": null
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "sources": [
    "tasks",
    "invoice_due",
    "fiscal_deadline",
    "absence"
  ]
}

GET /v1/agenda · 400 parameter_missing

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing",
    "message": "El parámetro 'from' es obligatorio.",
    "param": "from",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_missing",
    "request_id": "req_d4b51c21a90359eed7d82b665f"
  }
}

GET /v1/agenda · 400 parameter_invalid_range

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_range",
    "message": "El parámetro 'to' debe ser igual o posterior a 'from' y la ventana de fechas no puede superar 93 días (ambos días incluidos).",
    "param": "to",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_range",
    "request_id": "req_d7b867905a89ed06046c127984"
  }
}

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

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

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_param_value",
    "message": "El filtro assignee_id debe ser \"me\" o el id de un miembro de la empresa.",
    "param": "assignee_id",
    "doc_url": "https://docs.factuarea.com/guides/errors#invalid_param_value",
    "request_id": "req_03262b076bcc3326424b62eace"
  }
}

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

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

Listar elementos de la agenda

Authorization

Parámetros de consulta

Headers

Cuerpo de la respuesta

200application/json

400application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`