Factuarea API
Cuenta

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.

POST
/account/census-verification

Authorization

AuthorizationBearer <token>

En: header

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "object": "census_verification",
    "status": "identified",
    "verified_name": "Acme Soluciones SL",
    "checked_at": "2026-06-11T09:30:00Z"
  }
}

{
  "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": "idempotency_error",
    "code": "idempotency_key_reused",
    "message": "La cabecera `Idempotency-Key` ya se usó con un body distinto. Usa una clave nueva o reenvía exactamente el mismo body.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#idempotency_key_reused",
    "request_id": "req_01HKQS5NHT9A4U7R2E3F8GZWTJ"
  }
}

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

Obtener los detalles de la cuenta

Endpoint de cuenta estilo Stripe: devuelve la empresa autenticada junto con su plan, sus add-ons y los metadatos de la API key en uso (environment, scopes). Úsalo para introspeccionar qué puede hacer la clave actual.

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).