API Reference
API Rate Limits
To ensure the stability and reliability of the Cobra Connect Distribution platform, we implement rate limiting on all API endpoints. Limits are applied per IP address and/or per API Key.
Limit Schedule
| Scope | Sandbox | Production | Reset Period |
|---|---|---|---|
Global Requests Standard REST API endpoints | 60 req/min | 1,000 req/min | 60s Sliding Window |
Search & Catalog Product listings, search queries | 30 req/min | 300 req/min | 60s Sliding Window |
Ordering (Write) POST /orders, mutations | 10 req/min | 50 req/min | 60s Fixed Window |
Headers
Every API response includes user-friendly headers to help you manage your consumption.
X-RateLimit-LimitThe maximum number of requests you are permitted to make in the current window.
X-RateLimit-RemainingThe number of requests remaining in the current window.
X-RateLimit-ResetThe Unix timestamp when the current window resets.
Exceeding Limits
If you exceed the rate limit, the API will return a 429 Too Many Requests response. Your application should pause and retry after the time specified in the Retry-After header.