2xx means success, 4xx means the request was rejected, 5xx means something failed on the server.
Response Envelope
All responses — success and error — follow a consistent envelope. Success:error_code field mirrors the HTTP status code. For validation failures, data.errors contains the individual field messages:
Status Codes
Rate Limit Errors
When rate limited, thedata field includes how long to wait:
Customer Suspension
If acustomer_key belongs to a suspended customer, the request returns 403: