---
title: "Fetch Order Status"
method: GET
path: "/api/order/{id}/status"
tags: ["US Stock Trading"]
---

# Fetch Order Status

`GET /api/order/{id}/status`

## Request

- Base URL: `https://powered-by-bamboo-sandbox.investbamboo.com`
- URL: `https://powered-by-bamboo-sandbox.investbamboo.com/api/order/{id}/status`
- Auth: none declared. Required headers: `content-type`, `accept-language`, `x-user-id`, `x-subject-type`, `x-client-token`, `x-request-source`

This endpoint is used to check the status of an order that has been placed, providing comprehensive details about order execution and current state.

**Order status information includes:**
- Order identification with unique order ID and stock details
- Execution details showing order type, side (buy/sell), and quantity
- Pricing information with execution price and total value
- Fee breakdown in both USD and local currency
- Current status and any status change reasons
- Timestamps for order creation and updates

**Order Status Types:**
- **New:** Order received, awaiting execution
- **Filled:** Order successfully executed, shares/cash updated
- **Cancelled:** Order cancelled by the user before execution
- **Rejected:** Order rejected by broker (invalid parameters like the price or quantity passed)

## Path parameters

- `id` string, required

## Headers

- `content-type` string, required
- `accept-language` string, required
- `x-user-id` string, required
- `x-subject-type` string, required
- `x-client-token` string, required
- `x-request-source` string, required

## Response `200`

Order status

- OrderStatusResponse
  - `id` string: Order ID
  - `name` string: Stock name
  - `type` string: Type: Market, Stop, Limit
  - `symbol` string: Symbol
  - `logo` string: Stock logo
  - `quantity` number: Quantity requested
  - `side` string: Side Buy/Sell
  - `dollar_fee` unknown
  - `price` number: Price
  - `avatar` string: Stock avatar url
  - `naira_fee` unknown
  - `background_color` string: Background color of stock in hex
  - `order_status` string: Order status
  - `dollar_price` unknown
  - `naira_price` unknown
  - `limit_price` number: Limit price
  - `stop_price` number: Stop price
  - `commision` unknown
  - `created_when` string: Date in ISO 8601
  - `update_reason` string: Update reason if order was Rejected

## Other responses

- `401`: Token have expired or invalid token
- `404`: Resource not found
- `422`: Error response

---

[API](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api.md) - [All operations](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/revisions/063521e8d924?raw)