Límites y cuotas

Cada plan tiene una cuota por periodo, un límite por minuto y una ráfaga por segundo.

Plan	Precio	Consultas / periodo	Por minuto	Por segundo	Claves	Lote
Gratis	Gratis	1,000	30	2	1	—
Micro	S/ 5/mes	5,000	60	3	2	—
Básico	S/ 15/mes	60,000	120	5	3	—
Pro	S/ 25/mes	150,000	300	10	5	50
Empresa	S/ 45/mes	350,000	600	20	10	100

Qué cuenta y qué no

Cuenta: cada RUC encontrado (en /v1/ruc o dentro de un lote).
No cuenta: RUC no encontrados, RUC mal escritos, errores nuestros, /v1/uso, /v1/ubigeo, /v1/estado y las claves de prueba.
Los límites por minuto y por segundo sí cuentan todas las peticiones, se cobren o no, y se suman entre todas las claves de tu cuenta.

Periodos

En el plan Gratis la cuota se renueva el día 1 de cada mes (hora de Lima). En los planes de pago, cada 30 días desde que se activó el plan; el plan anual renueva la cuota cada 30 días durante 12 meses.

Paquetes extra

En planes de pago puedes comprar paquetes: 40 000 consultas por S/ 10 o 150 000 consultas por S/ 30. Valen 12 meses y se usan sólo cuando se acaba la cuota del periodo.

Cabeceras

Cabecera	Qué dice
`X-RateLimit-Limit`	Peticiones por minuto de tu plan.
`X-RateLimit-Remaining`	Las que te quedan en este minuto.
`X-RateLimit-Reset`	Segundos para que empiece el minuto siguiente.
`X-Quota-Limit`	Consultas incluidas en el periodo.
`X-Quota-Remaining`	Consultas que te quedan en el periodo.
`X-Quota-Reset`	Cuándo termina el periodo (ISO 8601).
`X-Credits-Remaining`	Créditos de paquetes que te quedan.
`Retry-After`	En un 429 por velocidad: cuántos segundos esperar.
`Server-Timing`	Cuánto tardó cada parte dentro de nuestro servidor.

Cuando recibes 429

limite_por_segundo o limite_por_minuto: espera lo que diga Retry-After y reintenta. Si te pasa seguido, reparte las peticiones o sube de plan.
cuota_agotada: no reintentes; no se va a resolver solo hasta el próximo periodo. Sube de plan o compra un paquete.

Te avisamos por correo cuando llegas al 80 % (lo puedes cambiar en Ajustes) y al 100 %.