Skip to main content
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"
  }
}
​
token
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-remaining and x-ratelimit-reset headers on other /v1/* endpoints.
See Rate Limits for more details about plans. 
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"
  }
}