---
title: "Get all listings"
method: GET
path: "/selling/listings"
tags: ["Listings"]
---

# Get all listings

`GET /selling/listings`

Get all listings API allows you to fetch all existing listings. Multiple filters are available.

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `productIds` string
- `variantIds` string
- `batchIds` string
- `fromDate` string
- `toDate` string
- `listingStatuses` string
- `inventoryTypes` string
- `initiatedShipmentDisplayIds` string
- `isExpired` boolean

## Response `200`

Ok

- Listings
  - `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.
  - `listings` ListListings[], required — List of listings
    - `listingId` string, required — Unique ID for this listing
    - `status` string, required — The current status of the listing<br><br>Available values: "INACTIVE", "ACTIVE", "DELETED", "CANCELED", "MATCHED", "COMPLETED"
    - `amount` string, nullable, required — The amount this product is being listed for
    - `currencyCode` string, nullable, required — The currency code. 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"
    - `inventoryType` string, nullable, required — A representation of the type of inventory being listed
    - `createdAt` string, required — When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
    - `updatedAt` string, required — When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
    - `batch` ListingsResponseBatch, required
      - `batchId` string — ID of the associated batch
      - `taskId` string — Id of the associated task
    - `ask` ListingResponseAsk, required
      - `askId` string, required — Id of the created ask
      - `askCreatedAt` string, required — When the ask was created
      - `askUpdatedAt` string, required — When the ask was updated
      - `askExpiresAt` string — When the ask will expire
    - `authenticationDetails` AuthenticationDetails, required
      - `status` string, nullable, required
      - `failureNotes` string, nullable, required
    - `order` ListingResponseOrder, required
      - `orderNumber` string, nullable, required — The order number. Standard example: 323314425-323214184. Flex example: 02-L0QT6MRVSG
      - `orderCreatedAt` string, nullable, required — When the order was created
      - `orderStatus` string, nullable, required — The status of the given order
    - `product` ListingResponseProduct, required
      - `productId` string, required — Unique ID for this product
      - `productName` string, nullable, required — The name of the product
      - `styleId` string, nullable, required — The style id of the product
    - `initiatedShipments` ManifestDataResponse, required
      - `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.
    - `variant` ListingResponseVariant, required
      - `variantId` string, required — Unique identifier that specifics a particular product.
      - `variantName` string, required — Unique readable name of the products variant
      - `variantValue` string, nullable, required — The value of the variant variant. For example, in the sneakers case, this could be 10 or in the trading cards case, this could be PSA 10, etc
    - `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/revisions/5b4ba84182d7/schema)