Factuarea API
Clients

Llistar la línia temporal d'activitat del client

Retorna la línia de temps d'auditoria d'un client combinant els seus propis esdeveniments de domini més els esdeveniments de factura, pressupost, albarà, proforma i factura de compra que el referencien. Paginada amb els query params page i per_page (50 per defecte).

GET
/clients/{client}/activities

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

client*string

Cos de la resposta

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": "client.updated",
      "description": "Se actualizó el correo electrónico del cliente.",
      "metadata": {
        "previous_email": "antiguo@acme.com",
        "new_email": "billing@acme.com"
      },
      "performed_by": {
        "type": "user",
        "id": "01928f12-1234-7abc-9def-0123456789ab",
        "name": "Ana García"
      },
      "created_at": "2026-05-15T10:34:21Z"
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_unknown",
    "message": "El parámetro 'per_page' no está reconocido por este endpoint.",
    "param": "per_page",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_unknown",
    "request_id": "req_01HKQS5N7UR6PWJ8K2T5BWPMZ9"
  }
}

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

Verificar el compte contra el cens de l'AEAT

Comprova el parell nom + NIF persistit de l'empresa contra el cens de l'AEAT (VNifV2) per anticipar rebutjos VeriFactu 4104. Sense cos de petició: l'endpoint verifica sempre les dades fiscals persistides del compte. Fail-open — si l'AEAT no està disponible, la crida retorna 200 amb `status: unavailable`. Les claus de prova (`fact_test_`) retornen estats deterministes segons el NIF màgic sense contactar amb l'AEAT.

Elimina diversos clients de forma massiva

Elimina fins a 200 clients en una petició. Retorna el recompte d'eliminacions i la llista d'UUIDs que no es van poder eliminar (els clients amb documents associats es reporten a failed).