---
title: "Get historical orders"
method: GET
path: "/selling/orders/history"
tags: ["Order"]
---

# Get historical orders

`GET /selling/orders/history`

Get all historical orders. Multiple filters are available.

## Query parameters

- `fromDate` string
- `toDate` string
- `pageNumber` integer
- `pageSize` integer
- `orderStatus` string
- `productId` string
- `variantId` string
- `inventoryTypes` string
- `initiatedShipmentDisplayIds` string

## Response `200`

Ok

- Orders
  - `count` number, double, required — Total number of items present
  - `pageSize` number, double, required — Total number of items in the current page
  - `pageNumber` number, double, required — Requested page number. Starts at 1.
  - `hasNextPage` boolean, required — Returns true if there are elements in the next page.
  - `orders` ListOrders[], required — List containing the orders
    - `orderNumber` string, required — The unique order number. Standard example: 323314425-323214184. Flex example: 02-L0QT6MRVSG
    - `listingId` string, nullable, required — Unique ID for this listing
    - `askId` string, required — Unique identifier for an ask on the StockX platform
    - `amount` string, required — The ask/order price
    - `currencyCode` string, nullable, required — The currency type for this order.<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"
    - `status` union, required — The current status of the order.
      - union — Status for the current order
        - 'CREATED' | 'CCAUTHORIZATIONFAILED' | 'SHIPPED' | 'RECEIVED' | 'AUTHENTICATING' | 'AUTHENTICATED' | 'PAYOUTPENDING' | 'PAYOUTCOMPLETED' | 'SYSTEMFULFILLED' | 'PAYOUTFAILED' | 'SUSPENDED' | 'PENDING' | 'DONOTSHIP'
        - 'AUTHFAILED' | 'DIDNOTSHIP' | 'CANCELED' | 'COMPLETED' | 'RETURNED'
        - 'UNKNOWN'
      - string
    - `createdAt` string, date-time, nullable, required — When the order was created in UTC. Represented as ISO 8601 format like 2021-08-25T13:51:47.000Z
    - `updatedAt` string, date-time, nullable, required — When the order was updated in UTC. Represented as ISO 8601 format like 2021-08-25T13:51:47.000Z
    - `product` OrderProduct, required — Product information
      - `productId` string, required — StockX product ID
      - `productName` string, nullable, required — Name of the product
      - `styleId` string, nullable, required — Style id of the product
    - `variant` Variant, required — Variant information
      - `variantId` string, required — Unique identifier for a products variant
      - `variantName` string, required — Unique readable name of the products variant
      - `variantValue` string, nullable, required — The value of the variant. For example, in the sneakers case, this could be 10 or in the trading cards case, this could be PSA 10, etc.
    - `authenticationDetails` AuthenticationDetails, required
      - `status` string, nullable, required
      - `failureNotes` string, nullable, required
    - `payout` Payout — The payout object that contains the payout details and any adjustments
      - `totalPayout` string, required — The total amount to be paid for the sale of the product
      - `salePrice` string, required — The amount the product was sold for
      - `totalAdjustments` string, required — The sum of all adjustments made
      - `currencyCode` string, required — The currency code this product is being listed in. If not provided, it will default to USD. Only valid currencies supported on stockx.com are supported via API.<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"
      - `adjustments` Adjustment[], required — The payout adjustment details if applicable
        - `adjustmentType` string, required — The type of adjustment made
        - `amount` string, required — The amount of the adjustment
        - `percentage` string, required — The percentage of the adjustment
    - `initiatedShipments` ManifestDataResponse
      - `inbound` object, required
        - `displayId` string, required — The ID associated with the shipment arriving at StockX. Note: This is the same ID generated when a Flex inbound list is created in StockX Pro.
    - `inventoryType` 'STANDARD' | 'FLEX' | 'DFS' | 'DIRECT', required
    - `condition` string, nullable, required — The condition of the item
    - `conditionDescription` string, nullable, required — A description of the item's condition

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/stockx/apis/stockx-public-api.md) · [All operations](https://skmtc.net/stockx/apis/stockx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockx/stockx-public-api/versions/5b4ba84182d7/schema)