> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lapyme.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limits

> Cuotas de la API pública de La Pyme y cómo manejar respuestas 429.

La cuota de la API pública se aplica por organización, no por credencial individual.

| Límite              | Valor                                           |
| ------------------- | ----------------------------------------------- |
| Cuota principal     | `5000` requests por hora por organización       |
| Burst protection    | `120` requests por minuto por organización      |
| Superficie afectada | API pública autenticada (`/api/v1/*`)           |
| Fuera de alcance    | `/health`, `OPTIONS`, rutas internas y webhooks |

Todas las API keys y todos los access tokens OAuth delegados de la misma organización comparten la misma cuota.

## Headers

Las responses incluyen headers de rate limit. Cuando recibís `429`, también recibís `Retry-After`.

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 30
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 30
RateLimit-Limit: 5000
RateLimit-Remaining: 0
RateLimit-Reset: 30
```

## Respuesta 429

```json theme={null}
{
  "request_id": "req_rate_limit_1",
  "error": {
    "type": "rate_limit_error",
    "code": "RATE_LIMITED",
    "message": "Se alcanzó el límite de solicitudes de la organización. Reintentá más tarde.",
    "retryable": true,
    "details": []
  }
}
```

## Qué hacer

1. Leé el header `Retry-After`.
2. Esperá esa cantidad de segundos.
3. Reintentá la misma operación después de la ventana de espera.

Si tu integración maneja retries automáticos, usá `Retry-After` como fuente de verdad para el backoff.