Usage and Limits

​

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.

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"
  }
}