Errores 429 y límite de consultas

Rate limit

El límite estándar es de 60 consultas por minuto por conexión.

Cómo evitar los 429

Diez respuestas 402 o 429 consecutivas bloquean la conexión por 24 horas: revisa ¿Por qué se bloqueó mi conexión?. Lo que más lo provoca son las ráfagas: varias consultas en el mismo segundo.

  • Envía las consultas secuencialmente, con una pausa breve entre cada una.
  • Ante cualquier error, espera unos segundos antes de reintentar. No reintentes de inmediato.
  • Lee Retry-After cuando venga en un 429 y respétala.
  • Monitorea X-RateLimit-Remaining en las respuestas exitosas: si baja mucho, espacia las llamadas.
  • Cachea en tu sistema los datos que no cambian a diario. Un caso real cachea la situación tributaria por 30 días y con eso su volumen real bajó a decenas de consultas al mes.

Las cabeceras disponibles:

Cabecera Significado
X-RateLimit-Limit Tope de la ventana que aplica
X-RateLimit-Remaining Consultas que aún puedes hacer
X-RateLimit-Reset Momento en que se renueva la ventana
Retry-After Segundos sugeridos antes de reintentar

Si necesitas procesar muchos RUT, revisa ¿Puedo consultar miles de RUT en un solo proceso?.

En esta página

Última actualización el 02/10/2026 por Anonymous