Precios y límites de la API
Qué cuesta la API, qué tier otorga cada plan y los topes por tier de peticiones, API keys y endpoints de webhook.
La API pública y el servidor MCP están incluidos en todos los planes de
pago de Factuarea. No hay ningún complemento que contratar ni solicitud de
acceso: crea una clave desde
Dashboard → Developers → API Keys
y empieza a llamar a /v1.
La capacidad también forma parte del plan: no existe un tier Developer API ni un boost que se pueda comprar por separado. Cambiar de plan cambia el tier efectivo de todas las claves existentes automáticamente.
Niveles
| Tier | Por minuto | Por mes | API keys activas | Endpoints de webhook |
|---|---|---|---|---|
| Free | 10 rpm | 100 | 1 | 0 |
| Starter | 30 rpm | 5.000 | 3 | 1 |
| Pro | 300 rpm | 50.000 | 25 | 10 |
| Scale | Según contrato | Según contrato | Según contrato | Según contrato |
Cifras de Free, Starter y Pro medidas en la fuente de configuración de tiers del backend el
2026-10-01. Para saber cómo se comportan las cuotas —ventana deslizante,
cabeceras X-RateLimit-*, ejes agregados de empresa y de cartera de la cuenta,
códigos 429 y estrategia de reintento— consulta
Límites de peticiones.
Una cuenta con dos o más NIF reales tiene además una cartera: sus peticiones se cuentan juntas, sea cual sea el NIF al que lleguen. Los techos de la cartera son planos por tier, así que dar de alta más NIF no los eleva, y los de por minuto y mensual solo observan por ahora. Lo que cuesta cada NIF adicional está en NIF adicionales.
Qué otorga ya tu plan
| Tu plan | Tier otorgado sin coste adicional |
|---|---|
| Trial (todavía sin suscripción activa) | Free |
| Esencial | Starter |
| Profesional | Pro |
| Avanzado | Pro |
| Enterprise | Scale |
El tier sigue al plan por sí solo: no se elige por clave ni por petición, y
cambia en cuanto cambia tu plan. Una migración histórica
grandfathered_addon puede conservar un tier superior mientras siga activo un
plan válido; los boosts heredados que no se migraron son inertes.
Topes que no son peticiones
Hay dos límites que se cuentan por empresa, no por petición.
API keys activas
Una clave cuenta mientras no esté revocada ni caducada; revocar una libera
hueco al momento. Crear una por encima del tope responde 422 con
code: max_api_keys_exceeded, indicando el tier y el tope. Para superarlo,
revoca una clave que ya no uses o cambia a un plan con un tier superior.
El tope de la tabla se cuenta por NIF. Una cuenta que tiene dos o más NIF reales
tiene además un tope para toda la cuenta, portfolio_max_api_keys: 1 en Free,
15 en Starter, 500 en Pro y 2.000 en Scale. Cuenta todas las claves de la cuenta
que no estén revocadas, también las de pruebas, se suma al tope por NIF y responde
422 con code: portfolio_max_api_keys_exceeded. Un solo NIF y su sandbox solo
encuentran el tope por NIF, y dar de alta más NIF no eleva el tope de la cuenta.
Mira los límites de peticiones.
Endpoints de webhook
Un endpoint cuenta mientras está vivo (active o degraded); uno
deshabilitado o borrado no cuenta. Crear uno por encima del tope responde
422 con code: business_rule_violation y
subcode: max_webhook_endpoints_reached.
En el tier Free el tope es 0, así que ya falla el primer endpoint —y
lo hace con 402 addon_required en vez del 422 de arriba, porque no hay
nada que liberar—. Los webhooks requieren un plan que otorgue Starter o
superior.
El modo test no es un tier más barato
Una clave fact_test_ lleva el mismo tier que tus claves de producción,
así que al tráfico de sandbox se le aplican las mismas cuotas por clave, por
minuto y mensuales. Los ejes agregados de empresa y de
cartera de la cuenta omiten las
empresas sandbox: el tráfico de prueba no consume la capacidad agregada de la
empresa live.
Lo que el sandbox quita es el efecto real, no la cuota: los registros de VeriFactu se crean en local y nunca se transmiten a la AEAT, los correos de documentos no llegan a destinatarios reales y los eventos quedan registrados pero no se entregan a tus endpoints. Tienes la lista completa en Modo test y sandbox.
Un tope sí se comporta distinto: las claves de test viven en una empresa sandbox aparte, así que consumen el cupo de claves de esa empresa y no el de tu empresa real.
Alto volumen
Scale no tiene precio publicado. La capacidad de peticiones, las API keys activas y los endpoints de webhook se acuerdan en el contrato Enterprise. Escribe a info@factuarea.com desde el correo asociado a tu empresa en Factuarea, con el volumen de peticiones que esperas y los endpoints que vas a usar si necesitas una ampliación auditada para tu empresa. Scale también incluye un acuerdo de nivel de servicio y gestor de cuenta dedicado.
Cómo ver lo que consumes
Dashboard → Developers → Usage
muestra tu consumo frente al tier actual. Cada respuesta de la API lleva
además las cabeceras X-RateLimit-*, la forma más barata de detectar que te
acercas al límite antes de alcanzarlo: cómo leerlas está en
Límites de peticiones.