Factuarea API
Series de documentos

Lista la línea temporal de actividad de la serie

Devuelve la línea de tiempo de auditoría de una serie combinando sus propios eventos de dominio (creación, archivado/desarchivado, cambios de predeterminado, consumo de numeración). Paginada con un cursor de número de página (`starting_after` es el número de la siguiente página).

GET
/series/{series}/activities

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

series*string

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

{
  "has_more": true,
  "next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c",
  "data": [
    {
      "object": "activity",
      "event_type": "series.created",
      "description": "Serie creada",
      "metadata": {},
      "performed_by": {
        "type": "user",
        "id": "019e5584-7a6d-736a-9f62-03f731ccae3a",
        "name": "Administrador"
      },
      "created_at": "2026-06-01T10:00:46+02:00"
    }
  ]
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "El campo `name` es obligatorio y no puede estar vacío.",
    "param": "name",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
    "request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Listar series activas por tipo de documento

Devuelve todas las series no archivadas del tipo de documento indicado dentro de tu empresa.

Archivar una serie

Archiva una serie para que deje de aparecer como disponible para nuevos documentos. Falla con 409 si la serie es la predeterminada y la única serie activa de su tipo. Devuelve 204 en caso de éxito.