curl "https://api.cnpj-api.com/v1/usage?token=YOUR_TOKEN"
{
"plan": "basic",
"rate_limit": {
"limit": 10,
"window": "1 minute",
"used": 3,
"remaining": 7,
"reset_at": "2026-04-20T22:31:00.000Z"
}
}
Endpoints
Usage and Limits
Current plan and live rate-limit usage for the authenticated token
GET
/
v1
/
usage
curl "https://api.cnpj-api.com/v1/usage?token=YOUR_TOKEN"
{
"plan": "basic",
"rate_limit": {
"limit": 10,
"window": "1 minute",
"used": 3,
"remaining": 7,
"reset_at": "2026-04-20T22:31:00.000Z"
}
}
string
Authentication token. Preferred authentication method.
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-remainingandx-ratelimit-resetheaders on other/v1/*endpoints.
Response
string
The token’s plan, for example
free, basic or pro.object
The token’s request limit and its usage in the current window.
curl "https://api.cnpj-api.com/v1/usage?token=YOUR_TOKEN"
{
"plan": "basic",
"rate_limit": {
"limit": 10,
"window": "1 minute",
"used": 3,
"remaining": 7,
"reset_at": "2026-04-20T22:31:00.000Z"
}
}
Was this page helpful?