# Cancel Order

Besides the required properties, either an orderId or a clientOrderId must be provided to cancel an order

Endpoint: DELETE /trading/api/v3/Orders
Version: 1.5.0
Security: api-key, nonce, timestamp, version, signature

## Header parameters:

  - `customer-number` (string, required)
    Defines which customer the request is executed for. If you manage multiple customers, this is how you switch between them. Use the _Customer Management_ API endpoints to get the customer data. Example: 'BTCS-CUS-123456'

## Request fields (application/json-patch+json):

  - `account` (integer, required)
    The account id of the traded currency of the order to cancel

  - `clientOrderId` (string,null)
    The custom defined client order id

  - `orderId` (integer)
    The Bitcoin Suisse order id

  - `cancelRequestId` (string,null)
    A custom id for this request, can be used for tracing purposes in case of rejection

  - `transactionTime` (string, required)
    Current timestamp (UTC), if the timestamp is too old when the request reaches the server, it is rejected

## Response 200 fields (application/json):

  - `account` (integer)

  - `clientOrderId` (string,null)

  - `orderId` (integer)

  - `quoteId` (integer)

  - `side` (string)
    Enum: "Unknown", "Buy", "Sell"

  - `orderType` (string)
    Enum: "Unknown", "Market", "Limit", "Stop", "StopLimit", "PreviouslyQuoted", "BestExecution"

  - `symbol` (string,null)

  - `currency` (string,null)

  - `quantity` (number)

  - `price` (number)

  - `stopPrice` (number)

  - `timeInForce` (string)
    Enum: "Unknown", "GoodTillCancel", "ImmediateOrCancel", "FillOrKill", "GoodTilDate"

  - `transactionTime` (string)

  - `expireTime` (string)

  - `createdAt` (string)

  - `toAccount` (integer)

  - `executionId` (string,null)

  - `executionType` (string)
    Enum: "Unknown", "New", "Cancelled", "Replaced", "PendingCancel", "Rejected", "Expired", "Trade", "Void", "OrderStatus"

  - `indicativePrice` (number)

  - `status` (string)
    Enum: "Unknown", "New", "PartiallyFilled", "Filled", "Cancelled", "PendingCancel", "Rejected", "PendingNew", "Expired", "Draft", "Error", "Submitted", "Void", "Cancelling", "CancelError"

  - `lastPrice` (number)

  - `lastQuantity` (number)

  - `cumulativeQuantity` (number)

  - `leavesQuantity` (number)

  - `rejectionCode` (integer)

  - `text` (string,null)

  - `availableToTrade` (number)

  - `commissionCurrency` (string,null)

  - `commission` (number)

  - `settlementDate` (string)

  - `venueId` (integer)

  - `tenor` (string)
    Enum: "Unknown", "Spot", "Instantly"

  - `prosecoFuseco` (boolean)

  - `isTwap` (boolean)

  - `isCommissionIncluded` (boolean)

  - `legPrice` (number)

  - `legSymbol` (string,null)

  - `settlementAmount` (number)

  - `fromAmount` (number)

  - `toAmount` (number)

  - `isSettled` (boolean)

  - `appliedCommissionPct` (number)

  - `targetStrategy` (string)
    Enum: "None", "Smart", "TWAP", "Scheduled", "DCA"

  - `durationUnit` (string)
    Enum: "Unknown", "Day", "Hour", "Month", "Minute", "Week"

  - `duration` (integer)

  - `pegOffsetType` (string)
    Enum: "None", "BasisPoints"

  - `pegOffsetValue` (integer)

  - `effectiveTime` (string)

  - `parentClientOrderId` (integer)

  - `source` (integer)

  - `isMinimumCommissionApplied` (boolean)

  - `legs` (array, required)

  - `legs.isFiatToFiat` (boolean)

  - `legs.rate` (number)

  - `legs.baseQuantity` (number)

  - `legs.venue` (string,null)

## Response 400 fields (application/json):

  - `messageType` (string)
    Enum: "Unknown", "GenericError", "ExecutionReport", "MarketDataRequest", "MarketDataRequestReject", "MarketDataRefreshSubscription", "OrderMassStatusRequest", "NewOrder", "OrderCancelReject", "OrderCancelReplaceRequest", "OrderCancelRequest", "OrderStatusRequest", "Quote", "QuoteRequest", "QuoteRequestReject", "SecurityList", "UnsubscribeAllMarketData", "CallbackRegister", "Instrument", "TimedEvent", "InstrumentsBegin", "InstrumentsEnd"

  - `cancelRequestId` (string,null)

  - `originalClientOrderId` (string,null)

  - `status` (string)
    Enum: "Unknown", "New", "PartiallyFilled", "Filled", "Cancelled", "PendingCancel", "Rejected", "PendingNew", "Expired", "Draft", "Error", "Submitted", "Void", "Cancelling", "CancelError"

  - `rejectionCode` (integer)

  - `rejectionText` (string,null)

  - `rejectResponseTo` (string)
    Enum: "Unknown", "CancelRequest", "ReplaceRequest"