---
title: "Errores 429 y límite de consultas"
description: "Cómo funciona el límite de 60 consultas por minuto, qué provoca los 429 y cómo evitarlos."
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-10-26"
last_update: "2026-10-26"
time_minutes: 2
draft: false
unlisted: false
url: "https://www.stage.apigateway.cl/docs/solucion-de-problemas/bloqueos-y-limites-de-uso"
---

# 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?](https://www.apigateway.cl/faq/conexiones/por-que-se-bloqueo-mi-conexion). 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?](https://www.apigateway.cl/faq/contribuyentes/puedo-hacer-consultas-masivas-de-rut).



---
Última actualización el 26/10/2026