Activate a listing

Activate listing API allows you to activate a listing. A listing is active when it contains an available ask.

Request
Security:
path Parameters
listingId
required
string

Unique ID for this listing

Request Body schema: application/json
amount
string

The amount this product is being listed 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

Responses
200
400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

put/selling/listings/{listingId}/activate
Request samples
application/json
{
  • "amount": "150",
  • "currencyCode": "USD",
  • "expiresAt": "2021-11-09T12:44:31.000Z"
}
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
}