Quotas & Rate Limits

Daily caps per tier, with X-RateLimit-* headers

3 min read

FreeMaint API enforces a daily quota per company, reset at midnight UTC. The cap depends on your tier; counters and remaining are exposed as response headers.

Daily caps

  • Core, Starter โ€” 0 (API access requires Business)
  • Business โ€” 5,000 calls/day (REST + GraphQL share the same pool)
  • Enterprise โ€” 100,000 calls/day
  • On-Premise โ€” Unlimited (cap = null)

Response headers

  • X-RateLimit-Limit โ€” your tier's daily cap
  • X-RateLimit-Remaining โ€” calls left today (decrements on every quota-counted call)
  • X-RateLimit-Reset โ€” Unix timestamp of midnight UTC (next reset)

What doesn't count

Calls that explicitly opt out of the quota (currently /public-api/whoami and the GraphQL whoami query) don't decrement your counter. They're free verification calls so you can check tier and key validity without burning quota.

When you exceed the cap

Once you hit your daily cap, every additional call returns 403 'Daily API cap reached'. The cap resets at 00:00 UTC. There's no soft-cap or burst โ€” it's a hard hourly window.

Tip

Monitor X-RateLimit-Remaining in your integration's dashboard so you can warn yourself before hitting the cap.

Was this page helpful?