Errors

{
  "error": {
    "code": "validation_error",
    "message": "The request contains invalid data.",
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication credentials are missing, invalid, or expired.",
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "insufficient_scope",
    "message": "The access token does not have permission to perform this action.",
    "required_scopes": [
      "orders:create"
    ],
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "The request contains invalid data.",
    "errors": {
      "items": [
        "The items field is required."
      ]
    },
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient available balance.",
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "This Idempotency-Key has already been used for a different request.",
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found.",
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please try again later.",
    "retry_after": 30,
    "request_id": "req_..."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred while processing the request.",
    "request_id": "req_..."
  }
}