Sign in
latestOpenAPI 3.0.0MIT2026-08-043290199.3 KB

5b4ba84182d7

Listings

Get single listing

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

get/selling/listings/{listingId}

Path parameters

listingIdstring required

Unique ID for this listing

Response

listingIdstring required

Unique ID for this listing

statusstring required

The current status of the listing<br><br>Available values: "INACTIVE", "ACTIVE", "DELETED", "CANCELED", "MATCHED", "COMPLETED"

amountstring nullable required

The amount this product is being listed for

currencyCodestring 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"

inventoryTypestring nullable required

A representation of the type of inventory being listed

createdAtstring required

When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

updatedAtstring required

When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

conditionstring nullable required

The condition of the item

conditionDescriptionstring nullable required

A description of the item's condition

Example response

{
  "listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "status": "ACTIVE",
  "amount": "300",
  "currencyCode": "AUD",
  "inventoryType": "STANDARD",
  "createdAt": "2021-11-09T12:44:31.000Z",
  "updatedAt": "2021-11-09T12:44:31.000Z",
  "batch": {
    "batchId": "86378f62-ad0e-4a06-9c8e-642731bb9140",
    "taskId": "7083634e-3bc5-4747-a4f3-768093074b5e"
  },
  "ask": {
    "askCreatedAt": "2021-11-09T12:44:31.000Z",
    "askUpdatedAt": "2021-11-09T12:44:31.000Z",
    "askExpiresAt": "2021-11-09T12:44:31.000Z"
  },
  "order": {
    "orderCreatedAt": "2021-11-09T12:44:31.000Z",
    "orderStatus": "CREATED"
  },
  "product": {
    "productId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
    "productName": "Nike Air",
    "styleId": "FV5029-006"
  },
  "variant": {
    "variantId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
    "variantName": "color",
    "variantValue": "black"
  },
  "payout": {
    "adjustments": [
      {
        "adjustmentType": "Shipping Fee (10%)"
      }
    ]
  },
  "lastOperation": {
    "operationId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
    "operationCreatedAt": "2021-11-09T12:44:31.000Z",
    "operationUpdatedAt": "2021-11-09T12:44:31.000Z",
    "changes": {
      "additions": {
        "active": true,
        "askData": {
          "amount": "100",
          "currency": "USD",
          "expiresAt": "2022-08-24T18:06:43.600Z"
        }
      },
      "updates": {
        "updatedAt": "2021-11-09T12:44:31.000Z"
      }
    }
  },
  "condition": "Used",
  "conditionDescription": "Brand new, never worn"
}