---
title: "Modify Order"
method: PUT
path: "/accounts/{account}/orders/{CustomerOrderId}"
tags: ["Orders"]
---

# Modify Order

`PUT /accounts/{account}/orders/{CustomerOrderId}`

Allows the caller to modify the order with the referenced Customer Order ID specified in the URL. A separate Customer Order ID must be provided in the request body for the modification.

## Request body

- object
  - `OrigCustomerOrderId` string — The order ID assigned by the customer
  - `CustomerOrderId` string — The new order ID assigned by the customer for the modification.
  - `Quantity` number — The number of units in the order; contracts or shares
  - `Price` number — The order price
  - `Order Type` 1 | 2 | 3 | 4 — Market = '1' Limit = '2' Stop = '3' StopLimit = '4'
  - `Aux Price` number — Required Price to support Stop and Stop Limit orders
  - `Time in Force` 0 | 1 | 2 | 3 | 7 — Defines order's active lifetime. Day = '0' GTC (Good till Cancel) = '1' IOC (Immediate or Cancel) = '3' Open = '2' Close = '7'
  - `Outside RTH` number — Indicates if order is active outside regular trading hours, where defined. 0 = no (default), 1 = yes
  - `Side` 1 | 2 — Buy = '1', Sell = '2'
  - `GermanHftAlgo` boolean — By setting this bool to false the customer attests that the order is not subject to German HFT Act, was not generated using any automated algorithm, and no algorithm determined or changed financial instrument, side, quantity, order type, limit or other price, trading venue or timing of this order. Currently we cannot accept orders where this flag is set to true. Such orders will be rejected.
  - `Mifid2DecisionMaker` string — This field permits specification of the user's preregistered (via account management) MiFID II short code for decision makers.
  - `Mifid2Algo` string — This field permits specification of the user's preregistered (via account management) MiFID II short code for algos that are responsible for investment decisions
  - `Mifid2ExecutionTrader` string — This field permits specification of the user's preregistered (via account management) MiFID II person responsible for handling/routing of the order
  - `Mifid2ExecutionAlgo` string — This field permits specification of the user's preregistered (via account management) MiFID II short code for algos that are responsible for handling/routing of the order.

## Response `200`

Result of order modification attempt

- object[]
  - `CustomerOrderId` string
  - `Symbol` number
  - `OrderQty` number
  - `Price` string
  - `Side` 1 | 2
  - `Status` '-1' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'A' | 'B' | 'C' | 'D' | 'E' — Status of the order InvalidOrderStatus = '-1' New = '0' PartiallyFilled = '1' Filled = '2' DoneForTheDay = '3' Canceled = '4' Replaced = '5' PendingCancelReplace = '6' Stopped = '7' Rejected = '8' Suspended = '9' PendingNew = 'A' Calculated = 'B' Expired = 'C' AcceptedForBidding = 'D' PendingReplace = 'E'
  - `Warning` string
  - `OrderType` 1 | 2 | 3 | 4 — Market = '1' Limit = '2' Stop = '3' StopLimit = '4'

## Other responses

- `202` — Unsuccessfull response
- `204` — Unsuccessfull response
- `400` — Unsuccessfull response
- `401` — Unsuccessfull response
- `403` — Unsuccessfull response
- `408` — Unsuccessfull response

---

[API](https://skmtc.dev/interactivebrokers/apis/ibkr-3rd-party-web-api.md) · [All operations](https://skmtc.dev/interactivebrokers/apis/ibkr-3rd-party-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactivebrokers/ibkr-3rd-party-web-api/revisions/97f75703dba5/schema)