Skip to main content

API Limits

Rate Limiting​

The API implements multi-tier rate limiting to ensure fair usage:

  • Burst Limit: 20 requests per second
  • Hourly Limit: 3,600 requests per hour

Rate limits are enforced per organization - all API keys for the same account share these limits. Exceeding either limit returns a 429 Too Many Requests response with retry details.

Rate Limit Response​

When you exceed a rate limit, the API returns:

{
  "code": "RATE_LIMIT_EXCEEDED",
  "error": "Too many requests",
  "message": "Rate limit exceeded. Maximum 20 requests per 1 seconds.",
  "retryAfter": 1,
  "resetAt": "2025-01-15T14:30:00.000Z"
}

The response includes:

  • code: Error code for programmatic handling
  • error: Human-readable error type
  • message: Detailed error message with limit information
  • retryAfter: Number of seconds to wait before retrying
  • resetAt: ISO 8601 timestamp when the rate limit window resets

If you need higher limits, please contact Kojo and we will be happy to work with you to support your use-case.

Maximum Fetch Request Size​

We limit our fetch requests to returning a maximum of 100 entities (anything with an id field) at a time. All of our fetch requests support pagination.