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 | 1.200 rpm | 5.000.000 | 100 | 50 |
Cifras verificadas contra la configuración de tiers del backend el
2026-08-27. Para saber cómo se comportan las cuotas —ventana deslizante,
cabeceras X-RateLimit-*, ejes agregados de empresa/cartera gestionada,
códigos 429 y estrategia de reintento— consulta
Límites de peticiones.
Qué otorga ya tu plan
| Tu plan | Tier otorgado sin coste adicional |
|---|---|
| Trial (todavía sin suscripción activa) | Free |
| Emprendedor | Starter |
| Empresario | 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.
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 cartera gestionada 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. Su capacidad incluida es la fila numérica anterior: hasta 100 claves activas y 50 endpoints de webhook, no un tier sin límites. 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.