---
title: "Get single listing"
method: GET
path: "/selling/listings/{listingId}"
tags: ["Listings"]
---

# Get single listing

`GET /selling/listings/{listingId}`

Get a listing API allows you to get a listing by its ID.

## Path parameters

- `listingId` string, required

## Response `200`

- ListingResponse
  - `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
  - `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
  - `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
  - `authenticationDetails` AuthenticationDetails, required
    - `status` string, nullable, required
    - `failureNotes` string, nullable, required
  - `payout` Payout, required — 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
  - `lastOperation` ListingResponseOperation, required
    - `operationId` string, required — Unique ID for this operation
    - `operationType` 'CREATE' | 'UPDATE' | 'DELETE' | 'ACTIVATE' | 'DEACTIVATE' | 'CANCEL_ORDER' | 'RECLAIM' | 'CANCEL_RECLAIM' | 'TPS_CHECK', required
    - `operationStatus` 'PENDING' | 'SUCCEEDED' | 'FAILED', required
    - `operationInitiatedBy` 'USER' | 'SYSTEM', required
    - `operationInitiatedVia` 'IOS' | 'ANDROID' | 'WEB' | 'STOCKX-PRO' | 'SCOUT' | 'SHOPIFY' | 'PUBLIC-API' | 'INTERNAL-SYSTEM', required
    - `operationCreatedAt` string, required — When the operation was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
    - `operationUpdatedAt` string, required — Time of the last update in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
    - `changes` ListingOperationsChangesDiff, required — JSON metadata object which include the changes of current listing
      - `additions` AdditionsRecursivePartialListingChangeableFields, required — The additions of current listing
      - `updates` UpdatesRecursivePartialListingChangeableFields, required — The updates of current listing
      - `removals` RemovalsRecursivePartialListingChangeableFields, required — The removals of current listing
    - `error` string, nullable — Operation error
  - `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.
  - `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
- `404` — Not Found
- `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)