Rate limits
Partner API requests are limited by category across fixed minute, hour, and day windows. These values reflect the current backend configuration.
| Category | Per minute | Per hour | Per day |
|---|---|---|---|
| Query | 250 | 3,000 | 20,000 |
| Retrieve | 150 | 1,500 | 5,000 |
| Write | 20 | 200 | 2,000 |
Query includes list operations such as brands, tickets, inspections, alerts, and digital risks. Retrieve includes inspection histories and digital risk evidence. Write includes ticket creation and approval-status updates. Other Partner API paths currently use the query category.
Response headers
X-RateLimit-Limit and X-RateLimit-Remaining report the minute window during normal operation. When a window is exceeded, the limit header reflects the exceeded window and remaining is zero.
When a limit is exceeded
The API returns HTTP 429 with error code Optimus-Err-0020. Reduce request frequency and retry with exponential backoff. Limits may change; use the response headers and avoid depending on a fixed retry interval.
