---
title: "List Account historical Orders"
method: GET
path: "/accounts/{accountID}/reports/order-history"
tags: ["Orders"]
---

# List Account historical Orders

`GET /accounts/{accountID}/reports/order-history`

Retrieves a list of Account Orders by accountID. The orders returned are ones that have been previously closed, either by being filled or by being canceled.

## Path parameters

- `accountID` string, required — The user's unique account identifier.

## Query parameters

- `from` string, required
- `to` string, required
- `limit` number
- `offset` string
- `direction` 'prev' | 'next'

## Response `200`

Retrieving a list of Account Orders was Successful

- OrderHistoryRes
  - `accountID` string — The user's unique account identifier.
  - `accountNo` string — The user's unique account number, that is human readable.
  - `tradingType` 'CASH' | 'MARGIN' — The type of trading the account will participate in.
  - `updated` string — Time of last update.
  - `orders` object[] — An array that holds a list of completed orders.
    - `orderID` string — A unique DriveWealth order identifier created when an order is placed.
    - `orderNo` string — A unique, human-readable DriveWealth order number.
    - `createdWhen` string
    - `symbol` string, nullable — The ticker symbol of the Instrument. Debt Instruments and Global Mutual Funds do not have symbols and are referred to buy their `instrumentID` or `ISIN`.
    - `cumQty` number — The amount of shares currently being transacted; larger orders may execute in chunks.
    - `orderStatus` 0 | 1 | 2 | 4 | 6 | 7 | 8 — The current status of the order, represented as a number.
    - `orderType` 'MARKET' | 'LIMIT' | 'STOP' | 'STOP_LIMIT' | 'MARKET_IF_TOUCHED' — The type of the Order.
    - `orderQty` number — The amount of the instrument in shares.
    - `isoTimeRestingOrderExpires` string — The time when the limit order expires.
    - `limitPrice` number — The price set for the limit order.
    - `side` 'B' | 'S' | 'BUY_OPEN' | 'BUY_CLOSE' | 'SELL_OPEN' | 'SELL_CLOSE' — The side of the order.
    - `mitTriggerPrice` number — Market If Touched trigger price. For MIT orders.
    - `triggered` number — The trigger price for limit orders.
    - `averagePriceRaw` number — The average price of purchase for the order.
    - `orderCashAmt` number — The amount of cash requested for an order (notional orders only).
    - `stopPrice` number — The stop price of a limit order.
    - `ISIN` string — An `International Securities Identification Number` (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. ISINs are commonly used when an Instrument does not have a `symbol`, such as Debt Instruments and Global Mutual Funds.

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)
