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

# Entendiendo la Quota

> Cómo funcionan los límites de uso de la API de Verifica

## Overview

Cada API key tiene una **quota** de uso que define cuántas solicitudes puedes realizar en un periodo de tiempo. La quota protege la estabilidad del servicio y se asigna según tu plan.

## Consulta tu quota en cada respuesta

No necesitas adivinar cuánta quota te queda: **cada respuesta de la API incluye dos cabeceras** (headers) que te dicen, en ese momento exacto, cuál es tu límite y cuánto has consumido. Vienen siempre, en todas las solicitudes, tengan o no éxito.

| Cabecera            | Qué te dice                                              |
| ------------------- | -------------------------------------------------------- |
| `X-Quota-Limit`     | El **total de solicitudes** que incluye tu plan.         |
| `X-Quota-Remaining` | El **número de solicitudes que aún te quedan** por usar. |

Para saber cuántas solicitudes ya consumiste, basta con restar una de la otra:

```
consumidas = X-Quota-Limit − X-Quota-Remaining
```

### Ejemplo

Si una respuesta trae estas cabeceras:

```http theme={null}
X-Quota-Limit: 1000
X-Quota-Remaining: 720
```

Significa que tu plan incluye **1000 solicitudes**, te quedan **720 disponibles** y ya has consumido **280**.

<Tip>
  Lee `X-Quota-Remaining` en tus respuestas para anticiparte: cuando se acerque a cero, podrás reducir el ritmo o avisar a tu equipo antes de recibir un `429`.
</Tip>

## Límite de solicitudes

Cuando superas el número de solicitudes permitido, la API responde con el código HTTP `429`:

| Código | Significado                                               |
| ------ | --------------------------------------------------------- |
| `429`  | Demasiadas solicitudes — se ha excedido el límite de rate |

<Note>
  Los valores exactos de tu quota dependen del plan contratado. Escríbenos a [soporte@verifica.id](mailto:soporte@verifica.id) para conocer o ampliar los límites de tu API key.
</Note>

## Recomendaciones

* **Controla el ritmo de tus solicitudes** para no agotar la quota en ráfagas cortas.
* **Implementa reintentos con backoff exponencial** cuando recibas un `429`, en lugar de reintentar de inmediato.
* **Cachea las respuestas** que no cambian con frecuencia para reducir el consumo.