APIAuthentication
RateLimits
Storrik API Ratelimit
Rate Limits
The Storrik API uses per second rate limits for fair usage and stable performance.
Rate limits depend on the plan associated with your secret API key.
Current Limits
| Plan | Requests per Second | Notes |
|---|---|---|
| Community | 5 | Strict, intended for small scale usage |
| Supporter | 500 | High performance tier |
| Supporter Plus | Unlimited | Subject to anti abuse protection |
Supporter Plus does not have a numeric limit, but abusive or automated flooding can still be throttled.
What Counts as an API Request
Any interaction with the API counts as a request. Examples:
- Creating payment intents
- Reading store data
- Managing orders
- Listing or updating products
Embeds and client side frames generally do not count as API usage because they call the checkout service, not your account quota.
Response Headers
Each API response includes headers so you can monitor your usage.
| Header | Description |
|---|---|
x-ratelimit-limit | Maximum requests allowed in the current second |
x-ratelimit-remaining | Requests left in the current second |
api-version | API version used for the request |
Example:
HTTP/1.1 200 OK
x-ratelimit-limit: 5
x-ratelimit-remaining: 4
api-version: 2025-11-07.alphaIf the limit is exceeded, the API returns 429 Too Many Requests:
{
"error": "Rate limit exceeded"
}You may retry after 1 second.