Skip to main content

Rate Limits

The PMF API uses rate limiting to ensure fair usage and maintain service quality for all users.

How Rate Limiting Works​

Request Limits​

Rate limits are enforced at multiple levels:

  1. Per Minute: Maximum 60 requests in any 60-second window
  2. Per Day: Maximum 1,000 requests in a 24-hour period (UTC)
  3. Per Month: Maximum 20,000 requests in a calendar month

Rate Limit Headers​

Every API response includes rate limit information:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1707064800
X-RateLimit-Tier: free
  • X-RateLimit-Limit: Your limit for the current period
  • X-RateLimit-Remaining: Requests remaining in current period
  • X-RateLimit-Reset: Unix timestamp when the limit resets
  • X-RateLimit-Tier: Current tier (always "free" )

Handling Rate Limits​

When You Hit a Limit​

When you exceed a rate limit, you'll receive a 429 response:

{
  "detail": "Rate limit exceeded. Limit: 60 requests per minute",
  "retry_after": 42
}

The retry_after field indicates seconds to wait before retrying.

Next Steps​