Factuarea API
Compte

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.

GET
/account

Authorization

AuthorizationBearer <token>

A: header

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "object": "account",
    "company": {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
      "name": "Acme Corporation",
      "tax_id": "B12345678"
    },
    "plan": {
      "slug": "enterprise",
      "name": "Enterprise"
    },
    "addon": {
      "active": true,
      "in_grace": false,
      "expires_at": null
    },
    "api_key": {
      "id": "019e81ef-e1d4-7208-a51d-94c2c2a54a84",
      "name": "Producción",
      "prefix": "fact_live_1OSf9KdP",
      "scopes": [
        "account:read",
        "series:read",
        "series:write"
      ],
      "tier": "scale",
      "created_at": "2026-01-15T09:30:00Z",
      "last_used_at": "2026-05-25T18:00:00Z",
      "expires_at": null
    }
  }
}

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

Migració des de Holded

Mapeig de recursos Holded → Factuarea, nomenclatura, endpoints equivalents i script en Python.

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.