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

# Límites de tasa

> Cómo se agrupan y se reportan las cuotas de la API de Croma Legal.

## Cuotas por organización

Los límites de tasa se aplican **por organización**, no por clave. Todas las
claves emitidas a la misma organización comparten una cuota, y las llamadas
hechas a través del [servidor MCP](/es/legal/mcp-server) consumen esa misma
cuota, así que agregar claves o clientes no multiplica tu límite.

| Cuota                | Límite                   | Endpoints                                                                                                            |
| -------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| Por defecto          | 1.000 solicitudes / 24 h | Todos los endpoints `/v1/*` y cada llamada a una herramienta MCP.                                                    |
| Consulta de trabajos | 600 / minuto             | [`GET /jobs/:id`](/es/legal/exports). Cuota propia, así que consultar una exportación nunca gasta tu cuota de datos. |

La ventana es deslizante: una solicitud hecha hace 24 horas libera su lugar.

## La cuota en los encabezados de respuesta

El estado del límite de tasa viene como encabezados HTTP en cada respuesta (no
en el cuerpo):

| Encabezado              | Significado                                                              |
| ----------------------- | ------------------------------------------------------------------------ |
| `X-RateLimit-Limit`     | Solicitudes permitidas en la ventana actual.                             |
| `X-RateLimit-Remaining` | Solicitudes restantes antes de ser limitado.                             |
| `X-RateLimit-Reset`     | Marca de tiempo ISO en la que se reinicia la ventana.                    |
| `X-Request-Id`          | Id único de la solicitud (`req_…`); inclúyelo en los reportes a soporte. |

## Cuando superas el límite

Las solicitudes por encima de la cuota devuelven `429` con un sobre
`rate_limit_error` y un encabezado `Retry-After` (segundos):

```json theme={"dark"}
{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Try again in 42 seconds."
  }
}
```

```
Retry-After: 42
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-08-22T09:14:33.000Z
```

Espera hasta que pase `Retry-After` (o `X-RateLimit-Reset`) y reintenta. Por
MCP, la llamada a la herramienta devuelve un mensaje de error en lugar de un
resultado.

<Note>
  El limitador **falla abierto**: si el backend de límites no está disponible
  por un momento, las solicitudes pasan y no se emiten encabezados
  `X-RateLimit-*`. No dependas de que los encabezados estén siempre presentes.
</Note>

## Cómo mantenerte lejos del límite

* Usa `page_size=100` al paginar; menos páginas y más grandes cuestan menos
  solicitudes.
* Para una copia completa de los datos, una [exportación](/es/legal/exports)
  reemplaza cientos de llamadas a las listas.
* Para agregados, llama una vez a
  [`GET /v1/analytics`](/es/legal/api-reference/get-analytics) en lugar de
  paginar filas para contarlas.
* Sincroniza de forma incremental con `since` en el feed de actuaciones
  (consulta [Paginación y filtros](/es/legal/pagination)) en lugar de releer el
  portafolio.

<Card title="Siguiente: Errores" icon="triangle-exclamation" href="/es/legal/errors">
  El sobre de error y todos los códigos de error.
</Card>