---
title: "Paginated order search with optional filtering by status, contract, and creation timestamp."
method: POST
path: "/api/Order/v2/query"
tags: ["Order"]
---

# Paginated order search with optional filtering by status, contract, and creation timestamp.

`POST /api/Order/v2/query`

## Request body

- SearchOrdersQueryRequest
  - `filter` GatewayOrderFilter, required
    - `accountId` integer, required
    - `statuses` OrderStatus[]
    - `contractId` string
    - `createdAfter` string, date-time
    - `createdBefore` string, date-time
  - `pageSize` integer
  - `pageOffset` integer
  - `sortBy` 0 | 1 — 0 = CreatedAt 1 = Id
  - `sortDirection` 0 | 1 — 0 = Asc 1 = Desc
  - `includeTotalCount` boolean

## Response `200`

A response with the matching page of orders and the optional total count.

- SearchOrdersQueryResponse
  - `success` boolean, required
  - `errorCode` 0 | 1, required — 0 = Success 1 = AccountNotFound
  - `errorMessage` string
  - `orders` OrderModel[]
    - `id` integer, required
    - `accountId` integer, required
    - `contractId` string, required
    - `symbolId` string, required
    - `creationTimestamp` string, date-time, required
    - `updateTimestamp` string, date-time, required
    - `status` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8, required — 0 = None 1 = Open 2 = Filled 3 = Cancelled 4 = Expired 5 = Rejected 6 = Pending 7 = PendingCancellation 8 = Suspended
    - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7, required — 0 = Unknown 1 = Limit 2 = Market 3 = StopLimit 4 = Stop 5 = TrailingStop 6 = JoinBid 7 = JoinAsk
    - `side` 0 | 1, required — 0 = Bid 1 = Ask
    - `size` integer, required
    - `limitPrice` number
    - `stopPrice` number
    - `fillVolume` integer, required
    - `filledPrice` number
    - `customTag` string
    - `trailDistance` integer
    - `trailPrice` number
    - `parentOrderId` integer
    - `linkedOrderId` integer
  - `totalCount` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/topstepx/apis/projectx-gateway-api.md) · [All operations](https://skmtc.dev/topstepx/apis/projectx-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/topstepx/projectx-gateway-api/revisions/688252f4f704/schema)