Skip to main content

Error Format

HTTP Status Codes

Authentication Errors

invalid_api_key (401)
missing_api_key (401)
rate_limit_exceeded (429)

Product Errors

invalid_url (400)
product_unavailable (404)
unsupported_marketplace (400)

Cart Errors

cart_not_found (404)
cart_expired (400)
shipping_unavailable (400)

Order Errors

order_not_found (404)
invalid_address (400)
wallet_screening_failed (403)

Best Practices

Retry Logic:
  • Retry 429 and 5xx errors with exponential backoff
  • Don’t retry 4xx errors (except 429)
Logging:
  • Always log request_id for support
User Messages:
  • Map error codes to user-friendly messages
  • Don’t expose technical details to users

Contact Support

Get help with errors