Errors

Standard error codes and responses returned by the API.

Error Response Format

All error responses follow a standard JSON format.

{
  "error": {
    "code": "invalid_request",
    "message": "The request body is missing required fields.",
    "details": {
      "field": "product_id",
      "reason": "Required"
    }
  }
}

Standard Error Codes

CodeStatusDescription
invalid_request400The request was unacceptable, often due to missing a required parameter.
authentication_error401No valid API key provided.
permission_error403The API key doesn't have permissions to perform the request.
not_found404The requested resource doesn't exist.
rate_limit_exceeded429Too many requests hit the API too quickly.
api_error500Something went wrong on our end.