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.

Request
Security:
Request Body schema: application/json
amount
required
string

The amount this product is being listed for

variantId
required
string

Unique StockX variant ID that this listing is being created for

currencyCode
string

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

Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"

expiresAt
string

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

active
boolean
Default: "true"

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

Responses
201

Created

400

Bad Request

401

Unauthorized

500

Internal Server Error

post/selling/listings
Request samples
application/json
{
  • "amount": "150",
  • "variantId": "98e2e748-8000-45bf-a624-5531d6a68318",
  • "currencyCode": "USD",
  • "expiresAt": "2021-11-09T12:44:31.000Z",
  • "active": true
}
Response samples
application/json
{
  • "listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
  • "operationId": "98e2e748-8000-45bf-a624-5531d6a68318",
  • "operationType": "CREATE",
  • "operationStatus": "PENDING",
  • "operationInitiatedBy": "USER",
  • "operationInitiatedVia": "IOS",
  • "createdAt": "2021-11-09T12:44:31.000Z",
  • "updatedAt": "2021-11-09T12:44:31.000Z",
  • "changes": {
    },
  • "error": null
}