> ## 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.

# Usage and Limits

> Current plan and live rate-limit usage for the authenticated token

<ParamField query="token" type="string">
  Authentication token. Preferred authentication method.
</ParamField>

## Notes

* This endpoint **does not count** against your rate limit.
* Use it to check your plan, current usage, and reset time before making queries.
* Remaining rate limit credits are returned in the `x-ratelimit-remaining` and `x-ratelimit-reset` headers on other `/v1/*` endpoints.

See [Rate Limits](/en/limites-de-uso) for more details about plans.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.cnpj-api.com/v1/usage?token=YOUR_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>