# GTT OrderBook

## GET /api/oms/orders/gtt

GTT OrderBook

to get the list of pending gtt, oco orders orders

### 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. |

### Responses

#### 200 — OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| s | string ("ok" | "no-data" | "error") | No |  |
| d | object[] | No |  |
| d[].symId | string | No |  |
| d[].exchange | string | No |  |
| d[].orderId | string | No |  |
| d[].side | string | No |  |
| d[].triggerType | string ("Single" | "OCO") | No |  |
| d[].single | object | No |  |
| d[].single.remarks | string | No | Any message entered during order entry |
| d[].single.trigPrice | number | No | Trigger price with respect to LTP |
| d[].single.product | string ("delivery" | "normal") | No | Product type of an order. 'delivery' is applicable for equities. 'normal' is applicable for derivatives. 'intraday' is applicable for both equity and derivatives |
| d[].single.type | string ("limit") | No |  |
| d[].single.qty | number | No |  |
| d[].single.price | number | No |  |
| d[].stopLoss | object | No |  |
| d[].stopLoss.remarks | string | No | Any message entered during order entry |
| d[].stopLoss.trigPrice | number | No | Trigger price with respect to LTP |
| d[].stopLoss.product | string ("delivery" | "normal") | No | Product type of an order. 'delivery' is applicable for equities. 'normal' is applicable for derivatives. 'intraday' is applicable for both equity and derivatives |
| d[].stopLoss.type | string ("limit") | No |  |
| d[].stopLoss.qty | number | No |  |
| d[].stopLoss.price | number | No |  |
| d[].target | object | No |  |
| d[].target.remarks | string | No | Any message entered during order entry |
| d[].target.trigPrice | number | No | Trigger price with respect to LTP |
| d[].target.product | string ("delivery" | "normal") | No | Product type of an order. 'delivery' is applicable for equities. 'normal' is applicable for derivatives. 'intraday' is applicable for both equity and derivatives |
| d[].target.type | string ("limit") | No |  |
| d[].target.qty | number | No |  |
| d[].target.price | 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. |