403 Forbidden
Error types
Rate limits
Each brand gets 60 calls a minute and 10,000 a day, shared by all its keys. MCP tool calls count the same as API calls. Every response carriesRateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers. A 429 also carries Retry-After.
Retries
Every version 1 call is aGET, so it’s always safe to retry.
- Retry a
429afterRetry-After. - Retry a
500or503with exponential backoff: 1s, 2s, 4s, at most 5 tries. - Don’t retry other 4xx errors. Fix the request instead.
X-Request-Id header. Quote it when you contact us.
Pagination
List endpoints return 25 items by default, and up to 100 withlimit. When has_more is true, pass next_cursor as cursor to get the next page.
