Rate limits
Understand API rate limits and pagination.
Overview
The Katura API enforces rate limits to ensure fair usage and platform stability.
Current rate limits
| Endpoint type | Rate limit |
|---|---|
| Admin API (read) | 120 requests/minute |
| Admin API (write) | 60 requests/minute |
| Storefront API | 300 requests/minute |
| Webhooks (outgoing) | No limit (sent asynchronously) |
Rate limit headers
Every API response includes rate limit headers:
X-RateLimit-Limit— maximum requests per windowX-RateLimit-Remaining— requests remaining in windowX-RateLimit-Reset— timestamp when window resets
Pagination
List endpoints use cursor-based pagination:
page— page number (default: 1)limit— items per page (default: 20, max: 100)- Response includes
total,page, andtotalPages