Limits and request ids
Rate limits, the size and count limits of each call, and the request id to quote when you contact us.
Rate limits
- Per key: 120 requests a minute, and 5,000 requests a day (the day resets at 00:00 UTC). Ask your contact if you need more.
- Answers carry
X-RateLimit-LimitandX-RateLimit-Remainingfor the per-minute limit. - Over a limit you get
429 rate_limitedwith aRetry-Afterheader in seconds. Wait that long, then try again. - Calls with a missing or wrong key are limited to 30 a minute per address.
Request ids
Every answer carries an X-Request-Id. Quote it when you contact us about a call, and we can find it in our logs.
All limits
| What | Limit |
|---|---|
| Requests per key | 120 a minute, 5,000 a day (00:00 UTC reset) |
| Calls with a missing or wrong key | 30 a minute per address |
Products per POST /api/v1/products | 50 |
Jobs per POST /api/v1/jobs | 50 |
| File name | 200 characters: letters A to Z, digits, -, _ and . |
| Request body | 4 MB. Images and 3D files go as links. |
Articles per GET /api/v1/assets?articles= | 100 |
Articles per page of ?since= | 100 |
| Article number | 1 to 64 characters: letters, digits, ., _ and - |
| Product name | 300 characters |
| Reference images per product | 10, by https link; JPEG, PNG or WebP, up to 10 MB each |
| Variants per product | 50 |
| Dimensions | Above 0 and below 10,000 cm per side |
| Event subscriptions | 3 active per company, https only |
| Event delivery | 10 second timeout; retries for about 21 hours |
| Signature tolerance | 5 minutes |
Need more? Ask your CharpstAR contact.