Errors & rate limits

Understand the error codes and rate-limit responses you may encounter.

Errors & rate limits

Common errors

  • 401 — missing or invalid x-api-key / signature.
  • 403 NOT_BETA_PARTNER — your partner account isn't approved for API access yet.
  • 429 RATE_LIMITED — you've exceeded your rate limit; back off and retry.

Rate limits

Limits are applied per API key. Monitor your consumption in the Usage tab of the Developer Portal, and design clients to handle 429 responses gracefully with exponential backoff.

Signing failures

If you get repeated 401s, verify you're signing the raw request body (byte-for-byte) and using the key's secret — not the prefix — as the HMAC key.