Activate a listing

Documentation

Support

Activate a listing

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

Request

Security:

api_keyjwt

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

Payload
curl
JavaScript
Node.js

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",
"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
}