Update a listing

Documentation

Support

Update a listing

Operation used to update an existing listing by its ID.

Request

Security:

api_keyjwt

path Parameters

listingId

required

string

Unique ID for this listing

Request Body schema: application/json

amount	string The amount that will appear on stockx.com The amount this product is being listed for
currencyCode	string Currency in which the ask is placed Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD" 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 When the ask expires UTC timestamp representing when this listing 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

500

Internal Server Error

patch/selling/listings/{listingId}

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
}