Sign in

v1

latestOpenAPI 3.0.0MIT2026-08-043290199.3 KB
Listings

Create a new listing

Create listings API allows you to create new listings. The listings correspond to an ask in the StockX UI. The listings can be for the same variant ID.

post/selling/listings

Request body

amountstring required

The amount this product is being listed for

variantIdstring required

Unique StockX variant ID that this listing is being created for

currencyCodestring

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"

expiresAtstring

UTC timestamp representing when this Ask should auto-expire. If not provided, it will default to 999 days from today. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

activeboolean

A flag that defaults to true, activating the listing on the StockX marketplace

inventoryTypestring

The inventory this product is being listed in. If not provided, it will default to STANDARD.<br><br>Available values: "STANDARD", "DIRECT"

Example request

{
  "amount": "150",
  "variantId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "currencyCode": "USD",
  "expiresAt": "2021-11-09T12:44:31.000Z",
  "active": true,
  "inventoryType": "STANDARD"
}

Response

Created

listingIdstring required

Unique ID for this listing

operationIdstring 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
operationUrlstring nullable required

The URL used for to poll the status of the operation.

operationInitiatedBy'USER' | 'SYSTEM' required
operationInitiatedVia'IOS' | 'ANDROID' | 'WEB' | 'STOCKX-PRO' | 'SCOUT' | 'SHOPIFY' | 'PUBLIC-API' | 'INTERNAL-SYSTEM' required
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

errorstring nullable

Error message if the creation failed

Example response

{
  "listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationUrl": "https://api.stockx.com/v2/selling/listings/c0a635ce-322f-49e1-9bfc-f954fc46f6bd/operations/d0a635ce-322f-49e1-9bfc-f954fc46f6be",
  "createdAt": "2021-11-09T12:44:31.000Z",
  "updatedAt": "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"
    }
  }
}