---
title: "get current orders list"
method: GET
path: "/orders"
tags: ["Orders"]
---

# get current orders list

`GET /orders`

The API lets you retrieve an array of all orders requested in a day with their last updated status.

## Headers

- `access-token` string, required

## Response `200`

Successful operation

- OrderResponse[]
  - `dhanClientId` string — User specific identification generated by Dhan
  - `orderId` string — Order specific identification generated by Dhan
  - `exchangeOrderId` string — Order specific identification generated by Exchange
  - `correlationId` string — The user/partner generated id for tracking back
  - `orderStatus` 'TRANSIT' | 'PENDING' | 'REJECTED' | 'CANCELLED' | 'PART_TRADED' | 'TRADED' | 'EXPIRED' — | **Enum Values** | **Description** | |-----------------|---------------------------------------------| | TRANSIT | Did not reach the exchange server | | PENDING | Reached at exchange end, awaiting execution | | REJECTED | Rejected at exchange/broker’s end | | CANCELLED | Cancelled by user | | PART_TRADED | Partially Executed | | TRADED | Executed | | EXPIRED | Validity of order is expired |
  - `transactionType` 'BUY' | 'SELL' — Signifies the type of transaction whether it's BUY or SELL
  - `exchangeSegment` 'NSE_EQ' | 'NSE_FNO' | 'BSE_EQ' | 'BSE_FNO' | 'MCX_COMM' — | **Enums** | **Exchange** | **Segment** | |--------------|--------------|-------------------| | NSE_EQ | NSE | Equity Cash | | NSE_FNO | NSE | Futures & Options | | BSE_EQ | BSE | Equity Cash | | BSE_FNO | BSE | Futures & Options | | MCX_COMM | MCX | Commodity |
  - `productType` 'CNC' | 'INTRADAY' | 'MARGIN' | 'MTF' | 'CO' | 'BO' — | **Enum Values** | **Description** | |-----------------|------------------------------------------------| | CNC | Cash & Carry for equity deliveries | | INTRADAY | Intraday for Equity, Futures & Options | | MARGIN | Carry Forward in Futures & Options | | CO | Cover Order; entry and stop loss | | BO | Bracket Order; entry, stop loss & target price | | MTF | Margin Traded Fund | **CO & BO product types will be valid only for Intraday**
  - `orderType` 'LIMIT' | 'MARKET' | 'STOP_LOSS' | 'STOP_LOSS_MARKET' — | **Enum Values** | **Description** | |------------------|-----------------------------| | LIMIT | For Limit Order types | | MARKET | For market Order types | | STOP_LOSS | For Stop Loss Limit orders | | STOP_LOSS_MARKET | For Stop Loss Market orders |
  - `validity` 'DAY' | 'IOC' — | **Enum Values** | **Description** | |-----------------|-----------------------| | DAY | Valid till end of day | | IOC | Immediate or Cancel |
  - `tradingSymbol` string — Exchange standard trading symbol
  - `securityId` string — Exchange standard identification for each scrip
  - `quantity` integer — Number of shares for the order
  - `disclosedQuantity` integer — Number shares visible in the market depth
  - `price` number, float — Price at which the order is requested to execute
  - `triggerPrice` number, float — Price at which the order is triggered
  - `afterMarketOrder` boolean — Flag to inform that the order placed is After Market Order
  - `boProfitValue` number, float — Bracket order Target price
  - `boStopLossValue` number, float — Bracket Order/Cover Order Stop Loss Price
  - `legName` 'ENTRY_LEG' | 'STOP_LOSS_LEG' | 'TARGET_LEG' | 'NA' — Order leg where modification is to be done
  - `createTime` string — Time at which the record is created
  - `updateTime` string — Time at which the record is updated
  - `exchangeTime` string — Time at which order reached at exchange end
  - `drvExpiryDate` string — For F&O, expiry date of contract
  - `drvOptionType` 'CALL' | 'PUT' | 'NA' — For Options, type CALL or PUT
  - `drvStrikePrice` number, float — For Options, Strike Price
  - `omsErrorCode` string — When order is rejected or failed, omsErrorCode would be populated
  - `omsErrorDescription` string — When order is rejected or failed, omsErrorDescription would be populated
  - `algoId` string — Algo_ID
  - `remainingQuantity` integer — Number of shares yet to be traded for the order
  - `averageTradedPrice` number, float — Average price at which order is traded
  - `filledQty` integer — Filled Quantity

---

[API](https://skmtc.dev/dhan/apis/dhanhq-api.md) · [All operations](https://skmtc.dev/dhan/apis/dhanhq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dhan/dhanhq-api/revisions/2d368b9ed32d/schema)