Update a listing

Operation used to update an existing listing by its ID.

Request
Security:
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
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
}