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

# Uso e Limites

> Plano atual e uso em tempo real do rate limit do token

<ParamField query="token" type="string">
  Token de autenticacao. Forma preferida de autenticacao.
</ParamField>

## Observacoes

* Este endpoint **nao consome creditos** do limite de requisicoes.
* Utilize para verificar seu plano, uso atual e horario de reset antes de fazer consultas.
* Os limites de requisicoes restantes sao retornados nos headers `x-ratelimit-remaining` e `x-ratelimit-reset` dos demais endpoints `/v1/*`.

Veja [Limites de Uso](/pt/limites-de-uso) para mais detalhes sobre os planos.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.cnpj-api.com/v1/usage?token=SEU_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "plan": "basic",
    "rate_limit": {
      "limit": 10,
      "window": "1 minute",
      "used": 3,
      "remaining": 7,
      "reset_at": "2026-04-20T22:31:00.000Z"
    }
  }
  ```
</ResponseExample>