Factuarea API
Clientes

Listar la línea temporal de actividad del cliente

Devuelve la línea de tiempo de auditoría de un cliente combinando sus propios eventos de dominio más los eventos de factura, presupuesto, albarán, proforma y factura de compra que lo referencian. Paginada con los query params page y per_page (50 por defecto).

GET
/clients/{client}/activities

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

client*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": "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 la cuenta contra el censo de la AEAT

Comprueba el par nombre + NIF persistido de la empresa contra el censo de la AEAT (VNifV2) para anticipar rechazos VeriFactu 4104. Sin cuerpo de petición: el endpoint verifica siempre los datos fiscales persistidos de la cuenta. Fail-open — si la AEAT no está disponible, la llamada devuelve 200 con `status: unavailable`. Las claves de prueba (`fact_test_`) devuelven estados deterministas según el NIF mágico sin contactar con la AEAT.

Elimina varios clientes de forma masiva

Elimina hasta 200 clientes en una petición. Devuelve el recuento de eliminaciones y la lista de UUIDs que no se pudieron eliminar (los clientes con documentos asociados se reportan en failed).