Create a new listing

Documentation

Support

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:

api_keyjwt

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

Payload
curl
JavaScript
Node.js

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",
"operationUrl": "https://api.stockx.com/v2/selling/listings/c0a635ce-322f-49e1-9bfc-f954fc46f6bd/operations/d0a635ce-322f-49e1-9bfc-f954fc46f6be",
"operationInitiatedBy": "USER",
"operationInitiatedVia": "IOS",
"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"
},
"removals": { }
},
"error": null
}