Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.invaro.ai/llms.txt

Use this file to discover all available pages before exploring further.

Rate limits are enforced per API key to ensure fair usage of the API and maintain service stability.
All rate limits are calculated on a per-minute basis and reset automatically at the start of each window.

​
Rate Limit Overview

Default Limits

  • 60 requests per minute per API key
  • Batch operations count as multiple requests
  • Rolling window reset

Batch Operations

Each item in a batch counts as one request:
  • Uploading 10 files = 10 requests
  • Processing 5 statements = 5 requests

​
Rate Limit Headers

The API includes rate limit information in the response headers:
​
Rate Limit Headers
object

​
Handling Rate Limits

  1. Monitor Headers Check the X-RateLimit-Remaining header to track your remaining requests.
  2. Implement Backoff When you receive a rate limit error, wait until the reset time before retrying: 
    {
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests",
    "details": "Please wait before making more requests"
  }
}
  3. Optimize Requests Use batch operations when possible to maximize your rate limit usage.

​
Best Practices

Implement Exponential Backoff

When rate limited, use exponential backoff to prevent overwhelming the API:
function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function makeRequest(retries = 3) {
  for (let i = 0; i < retries; i++) {
    try {
      return await apiRequest();
    } catch (error) {
      if (error.code !== 'RATE_LIMIT_EXCEEDED') throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

Batch Processing

Group multiple items into single requests:
// Instead of multiple single uploads
const files = ['doc1.pdf', 'doc2.pdf', 'doc3.pdf'];
const formData = new FormData();
files.forEach(file => formData.append('files', file));

// Single batch upload
await api.upload(formData);

​
Need Higher Limits?

Enterprise Plans

For higher rate limits and dedicated support, contact our sales team.Enterprise plans include:
  • Custom rate limits
  • Priority support
  • Dedicated account manager