---
title: "Get order detail"
method: GET
path: "/orders/{orderId}"
tags: ["Flash"]
---

# Get order detail

`GET /orders/{orderId}`

Fetch a single Flash order with its execution fills.

## Path parameters

- `orderId` string, uuid, required — Flash order ID.

## Query parameters

- `funderAddress` string, required — Funder wallet address that placed the order.

## Response `200`

Order detail returned successfully

- FlashGetOrderResponse
  - `order` FlashOrder, required
    - `orderId` string, required
    - `orderType` 'market' | 'limit' | 'twap' | 'stop' | 'stop-loss' | 'take-profit' | 'bracket', required
    - `side` 'buy' | 'sell', required
    - `status` 'ORDER_STATUS_UNSPECIFIED' | 'ORDER_STATUS_PENDING' | 'ORDER_STATUS_ACCEPTED' | 'ORDER_STATUS_PARTIALLY_FILLED' | 'ORDER_STATUS_FILLED' | 'ORDER_STATUS_CANCELLED' | 'ORDER_STATUS_REJECTED' | 'ORDER_STATUS_TERMINATED', required
    - `closeReason` string, nullable, required — Reason the order was closed (e.g. `REASON_USER_REQUESTED`, `REASON_FULLY_FILLED`); null while the order is still active.
    - `funderAddress` string, required
    - `targetAsset` FlashAssetRef, required
      - `id` string, required
      - `name` string, required
      - `address` string, required
      - `ticker` string, required
      - `chain` FlashAssetChainRef, required
        - `id` string, required
        - `name` string, required
        - `namespace` string, required
    - `contraAsset` FlashAssetRef, required
      - `id` string, required
      - `name` string, required
      - `address` string, required
      - `ticker` string, required
      - `chain` FlashAssetChainRef, required
        - `id` string, required
        - `name` string, required
        - `namespace` string, required
    - `qty` string, required
    - `filled` FlashOrderFilled, nullable, required
      - `targetAmount` string, nullable, required
      - `contraAmount` string, nullable, required
      - `averagePrice` string, nullable, required
      - `averageNotionalPrice` string, nullable, required
    - `limitNotionalPrice` string, nullable, required
    - `limitCrossPrice` string, nullable, required
    - `trigger` object, nullable, required
      - `notionalPrice` string — USD-price trigger on the traded (`targetAsset`) asset.
      - `crossPrice` string — Pair-rate trigger — price of `targetAsset` denominated in `contraAsset`. Mutually exclusive with `notionalPrice`.
      - `triggerType` 'upper' | 'lower', required — "lower": fires when market drops to/below the price. "upper": rises to/above.
    - `brackets` PriceTrigger[], nullable, required
      - `notionalPrice` string — USD-price trigger on the traded (`targetAsset`) asset.
      - `crossPrice` string — Pair-rate trigger — price of `targetAsset` denominated in `contraAsset`. Mutually exclusive with `notionalPrice`.
      - `triggerType` 'upper' | 'lower', required — "lower": fires when market drops to/below the price. "upper": rises to/above.
    - `maxPriceImpact` string, nullable, required
    - `twapBucketCount` integer, nullable, required
    - `placedAt` string, date-time, required
    - `acceptedAt` string, date-time, nullable, required
    - `closedAt` string, date-time, nullable, required
    - `expiresAt` string, date-time, nullable, required — When the order expires. Null for good-til-cancelled orders (no `expireTime` was set) and for market orders.
  - `fills` FlashFill[], required
    - `status` 'CHAIN_STATUS_UNSPECIFIED' | 'CHAIN_STATUS_PROCESSED' | 'CHAIN_STATUS_REORGED' | 'CHAIN_STATUS_FINALIZED', required — On-chain status of the fill.
    - `notional` string, required
    - `venues` string[], required
    - `filledAt` string, date-time, required
    - `rootOrderId` string, required
    - `orderId` string, required — Order id this fill belongs to. For TWAP orders, this is the child slice that produced the fill; for all other order types it equals `rootOrderId`.
    - `parentOrderId` string, required
    - `transactionId` string, required
    - `fillPrice` string, required
    - `feeAmount` string, required — Total fee for this fill, denominated in `feeTicker`: Definitive's platform fee + network fee + your integrator fee.
    - `feeTicker` string, required
    - `tradeFeeAmount` string, required — Definitive's platform fee for this fill, denominated in `feeTicker`. Does not include your integrator fee.
    - `networkFeeAmount` string, required
    - `integratorFeeAmount` string, required — Your integrator fee for this fill, denominated in `feeTicker`. "0" when no integrator fee was charged.
    - `feeNotional` string, required — Total fee for this fill in USD — `feeAmount` converted at the `feeTicker` rate: Definitive's platform fee + network fee + your integrator fee.
    - `tradeFeeNotional` string, required
    - `networkFeeNotional` string, required
    - `integratorFeeNotional` string, required — Your integrator fee for this fill, in USD.
    - `contraAmount` string, required
    - `targetAmount` string, required

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `403` — Permission denied
- `404` — Resource not found
- `422` — Resource state prevents the requested operation
- `429` — Rate limit exceeded
- `500` — Internal server error
- `503` — Service temporarily unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/definitive/apis/definitive-flash-api.md) · [All operations](https://skmtc.net/definitive/apis/definitive-flash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/definitive/definitive-flash-api/versions/4b43a78e1989/schema)