Factuarea API
Compte

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.

POST
/account/census-verification

Authorization

AuthorizationBearer <token>

A: header

Cos de la resposta

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

Obtenir els detalls del compte

Endpoint de compte estil Stripe: retorna l'empresa autenticada juntament amb el seu pla, els seus add-ons i les metadades de l'API key en ús (environment, scopes). Fes-lo servir per introspeccionar què pot fer la clau actual.

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