Errors and Limits
Explore the errors and rate-limits that you could encounter whilst using the API
Types
Errors will only ever be present within the 400 to 503 response status range.
4xx errors will be inside the response JSON (response.status), whilst 5xx errors are sent as an HTTP status code.
With the exception of rate-limiting errors (429), which are served by Cloudflare, and have both a response.status JSON and the HTTP 429 status code.
All errors will include a response.error attribute detailing the error message.
The Sellix API uses the following error codes:
| Code | Description |
|---|---|
400 | Bad Request - Invalid parameters. |
401 | Unauthorized - Unable to authenticate. |
403 | Forbidden - The request is not allowed. |
404 | Not Found - The specified resource could not be found. |
406 | Not Acceptable - You requested a format that isn’t json. |
429 | Too Many Requests - You have reached the rate limit. |
500 | Internal Server Error - We had a problem with our server. Try again later. These are rare. |
503 | Service Unavailable - We’re temporarily offline for maintenance. Please try again later. |
Rate-limits
Rate-limiting errors (429) happen when you are sending too many requests to the developers API.
How it works
Our rate-limiting system is based on 10-second intervals rather than 1, meaning that you can make a burst of API calls within the first second, then wait 9 seconds and do it again.
Standard tier with 50 req/10s, you can send 50 requests within a second, then wait 9 seconds to send the others and it would work.If you go over the allowed rate-limit for your tier, we .
General endpoints
All Sellix API endpoints are rate-limited. Based on your tier, you have access to different rate-limiting values.
| Tier | Limits |
|---|---|
Standard | 50 req/10s |
Tier 1 | 75 req/10s |
Tier 2 | 100 req/10s |
Tier 3 | 500 req/10s |
Payment endpoints
If you are on the standard version, payment endpoints are highly restricted compared to the general endpoints.
| Tier | Limits |
|---|---|
Standard | 10 req/10s |
Tier 1 | 75 req/10s |
Tier 2 | 100 req/10s |
Tier 3 | 500 req/10s |