# Orders

## GET /api/oms/orders

Orders

to get list of orders placed

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| Authorization | header | string | Yes | Access token in the following format:  Bearer <api_key>:<access_token>  Both values are required. The `api_key` is your app credential from the Apps Section. The `access_token` is obtained from the authentication endpoint and is valid for 24 hours. |
| symDetails | query | boolean (true | false) | No | Sending symDetails:'true' - will provide the symbol object in response for every record. Symbol object contains details such as price-tick, lotsize, token etc.., |

### Responses

#### 200 — OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| s | string ("ok" | "no-data" | "error") | No |  |
| d | object[] | No |  |
| d[].symId | string | No |  |
| d[].status | string ("open" | "completed" | "rejected" | "cancelled") | No |  |
| d[].qty | number | No | Order quantity |
| d[].side | string ("buy" | "sell") | No |  |
| d[].type | string ("limit" | "market" | "stoplimit" | "stopmarket") | No |  |
| d[].validity | string ("day" | "ioc" | "eos" | "gtc") | No |  |
| d[].validTill | string | No |  |
| d[].source | string | No |  |
| d[].limitPrice | number | No |  |
| d[].exchOrderId | string | No |  |
| d[].discQty | number | No |  |
| d[].product | string ("delivery" | "normal" | "intraday" | "cover" | "bracket") | No |  |
| d[].exchTime | string | No | Exchange order time in the format 'dd-MM-yyyy HH:mm:ss' |
| d[].orderId | string | No |  |
| d[].orderTime | string | No | Order time in the format 'dd-MM-yyyy HH:mm:ss' |
| d[].avgPrice | number | No |  |
| d[].amo | boolean | No |  |
| d[].fillQty | number | No |  |
| d[].trigPrice | number | No | This is required only for stoploss limit and stoploss market orders |
| d[].reason | string | No |  |
| d[].pendingQty | number | No |  |
| d[].sym | object | No |  |
| d[].sym.id | string | No |  |
| d[].sym.symbol | string | No |  |
| d[].sym.tradSymbol | string | No |  |
| d[].sym.exchange | string | No |  |
| d[].sym.lot | string | No |  |
| d[].sym.instrument | string | No |  |
| d[].sym.companyName | string | No |  |
| d[].sym.expiry | string | No |  |
| d[].sym.dispSymbol | string | No |  |
| d[].sym.asset | string | No |  |
| d[].sym.empty | boolean | No |  |
| d[].mktProt | number | No |  |
| d[].stopTrigPrice | number | No | Stop loss leg order trigger price. |
| d[].targetPrice | number | No | Target order or Profit order price |
| d[].trailingStopPrice | number | No | Trailing stop loss price. |
| d[].remarks | string | No | Remarks added while placing an order. |
| d[].legType | string ("main" | "stoploss" | "target") | No | Leg Type. Applicable only for Cover and Bracket order. |
| d[].mainLegOrderId | string | No | Main leg order id. Applicable only for Bracket and Cover order. It is used to exit the order. |
| d[].orderValue | number | No |  |
| d[].tradeValue | number | No | 'tradeValue' is filled quantity * average price |
| d[].algType | string ("trailing" | "regular") | No | Algo type 'trailing' or 'regular' |
| d[].modifiable | boolean | No |  |
| d[].cancellable | boolean | No |  |
| d[].exitable | boolean | No |  |
| d[].retriable | boolean | No |  |
| d[].orderPoll | boolean | No |  |
| d[].stopLimitPrice | number | No |  |
| msg | string ("no-data" | "error msg") | No |  |
| s | string ("ok" | "error" | "no-data") | No |  |

#### 401 — Unauthorized — one of: (1) invalid or expired access token — tokens expire after 24 hours, re-authenticate to get a new one; (2) `Authorization` header missing or malformed — use format `Bearer <api_key>:<access_token>`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| s | string ("error") | No | Response status. Always `error` for error responses. |
| msg | string ("Unauthorized") | No | Error message. |

#### 429 — Too Many Requests — rate limit exceeded. General API: 10 req/sec per auth token (400 req/min).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| s | string ("error") | No | Response status. Always `error` for error responses. |
| msg | string | No | Error message indicating the rate limit was exceeded. |

#### 500 — Internal Server Error — retry with backoff; contact support if it persists.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| s | string ("error") | No | Response status. Always `error` for error responses. |
| msg | string | No | Error message. |