> For the complete documentation index, see [llms.txt](https://docs.openalgo.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openalgo.in/api-documentation/v1/orders-api/orderstatus.md).

# OrderStatus

Get the current status of a specific order by its order ID.

## Endpoint URL

```http
Local Host   :  POST http://127.0.0.1:5000/api/v1/orderstatus
Ngrok Domain :  POST https://<your-ngrok-domain>.ngrok-free.app/api/v1/orderstatus
Custom Domain:  POST https://<your-custom-domain>/api/v1/orderstatus
```

## Sample API Request

```json
{
  "apikey": "<your_app_apikey>",
  "orderid": "250828000185002",
  "strategy": "Test Strategy"
}
```

## Sample cURL Request

```bash
curl -X POST http://127.0.0.1:5000/api/v1/orderstatus \
  -H 'Content-Type: application/json' \
  -d '{
  "apikey": "<your_app_apikey>",
  "orderid": "250828000185002",
  "strategy": "Test Strategy"
}'
```

## Sample API Response

```json
{
  "status": "success",
  "data": {
    "action": "BUY",
    "average_price": 18.95,
    "exchange": "NSE",
    "order_status": "complete",
    "orderid": "250828000185002",
    "price": 0,
    "pricetype": "MARKET",
    "product": "MIS",
    "quantity": "1",
    "symbol": "YESBANK",
    "timestamp": "28-Aug-2025 09:59:10",
    "trigger_price": 0
  }
}
```

## Request Body

| Parameter | Description           | Mandatory/Optional | Default Value |
| --------- | --------------------- | ------------------ | ------------- |
| apikey    | Your OpenAlgo API key | Mandatory          | -             |
| orderid   | Order ID to query     | Mandatory          | -             |
| strategy  | Strategy identifier   | Optional           | -             |

## Response Fields

| Field  | Type   | Description          |
| ------ | ------ | -------------------- |
| status | string | "success" or "error" |
| data   | object | Order details object |

### Data Object Fields

| Field          | Type   | Description                       |
| -------------- | ------ | --------------------------------- |
| orderid        | string | Order ID                          |
| symbol         | string | Trading symbol                    |
| exchange       | string | Exchange code                     |
| action         | string | BUY or SELL                       |
| quantity       | string | Order quantity                    |
| price          | number | Order price (0 for MARKET orders) |
| trigger\_price | number | Trigger price for SL orders       |
| pricetype      | string | MARKET, LIMIT, SL, SL-M           |
| product        | string | MIS, CNC, NRML                    |
| order\_status  | string | Current order status              |
| average\_price | number | Average execution price           |
| timestamp      | string | Order timestamp                   |

## Order Status Values

| Status    | Description                          |
| --------- | ------------------------------------ |
| complete  | Order fully executed                 |
| open      | Order pending execution              |
| pending   | Trigger order waiting for activation |
| rejected  | Order rejected by exchange           |
| cancelled | Order cancelled by user              |

## Notes

* Use this endpoint to track order execution status
* The **average\_price** field shows the actual execution price
* For partial fills, check both quantity and filled quantity
* Timestamps are in IST (Indian Standard Time)

***

**Back to**: [API Documentation](/api-documentation/v1.md)