NOTHINGPHISHY
NOTHINGPHISHY / GETTING STARTED

Rate limits

Partner API requests are limited by category across fixed minute, hour, and day windows. These values reflect the current backend configuration.

CategoryPer minutePer hourPer day
Query2503,00020,000
Retrieve1501,5005,000
Write202002,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.

NOTHINGPHISHY / API GUIDE