Skip to main content

​
Overview

Aifano enforces rate limits to ensure fair usage and platform stability. Limits are applied per organization and vary by plan.

​
Rate Limits by Plan

PlanRequests per MinuteConcurrent JobsMonthly Credits
Free2051,000
Pro1002010,000
EnterpriseCustomCustomCustom
Contact [email protected] for Enterprise plan details and custom rate limits.

​
Concurrency Limits

Concurrency limits control how many documents can be processed simultaneously. This applies to both sync and async endpoints.
Endpoint TypeFreeProEnterprise
Sync (/parse, /extract, etc.)520Custom
Async (/parse_async, etc.)520Custom
Upload (/upload)1050Custom

​
Rate Limit Headers

Rate limit information is included in API response headers:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the rate limit resets

​
Handling Rate Limits

When you exceed the rate limit, the API returns a 429 Too Many Requests response: 
{
  "error": "Rate limit exceeded. Please retry after 30 seconds.",
  "retry_after": 30
}

​
Retry Strategy

Implement exponential backoff when you receive a 429 response: 
import time
import requests

def call_with_retry(url, headers, json_data, max_retries=5):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=json_data)

        if response.status_code == 429:
            wait_time = min(2 ** attempt, 60)  # Max 60s
            print(f"Rate limited. Retrying in {wait_time}s...")
            time.sleep(wait_time)
            continue

        return response

    raise Exception("Max retries exceeded")

​
Best Practices

Submit all jobs via async endpoints first, then poll for results. This is more efficient than sequential sync calls and avoids hitting rate limits.
When you receive a 429 response, wait before retrying. Double the wait time with each retry (1s, 2s, 4s, 8s…) up to a maximum of 60 seconds.
Check X-RateLimit-Remaining in response headers to proactively slow down before hitting the limit.
Instead of sending 100 requests at once, spread them evenly across the minute to stay within rate limits.
If your use case requires higher rate limits, reach out to [email protected] to discuss Enterprise plans.

​
Credit Limits vs. Rate Limits

TypeScopeResetError Code
Rate LimitRequests per minuteEvery minute429
Credit LimitCredits per monthMonthly429 with CREDIT_LIMIT_EXCEEDED
Rate limits restrict how fast you can make requests. Credit limits restrict how much processing you can do per month. Both return 429 status codes but with different error messages.