Sign in

v1

latestOpenAPI 3.0.0MIT2026-08-043290199.3 KB
Listings

Update a listing

Operation used to update an existing listing by its ID.

patch/selling/listings/{listingId}

Path parameters

listingIdstring required

Unique ID for this listing

Request body

amountstring

The amount that will appear on stockx.com The amount this product is being listed for

currencyCodestring

Currency in which the ask is placed<br><br>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.<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"

expiresAtstring

When the ask expires UTC timestamp representing when this listing should auto-expire. If not provided, it will default to 999 days from today. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

Example request

{
  "amount": "150",
  "currencyCode": "USD",
  "expiresAt": "2021-11-09T12:44:31.000Z"
}

Response

listingIdstring required

Unique ID for this listing

operationIdstring required

Unique ID for this operation

operationType'CREATE' | 'UPDATE' | 'DELETE' | 'ACTIVATE' | 'DEACTIVATE' | 'CANCEL_ORDER' | 'RECLAIM' | 'CANCEL_RECLAIM' | 'TPS_CHECK' required
operationStatus'PENDING' | 'SUCCEEDED' | 'FAILED' required
operationUrlstring nullable required

The URL used for to poll the status of the operation.

operationInitiatedBy'USER' | 'SYSTEM' required
operationInitiatedVia'IOS' | 'ANDROID' | 'WEB' | 'STOCKX-PRO' | 'SCOUT' | 'SHOPIFY' | 'PUBLIC-API' | 'INTERNAL-SYSTEM' required
createdAtstring required

When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

updatedAtstring required

When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

errorstring nullable

Error message if the creation failed

Example response

{
  "listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationUrl": "https://api.stockx.com/v2/selling/listings/c0a635ce-322f-49e1-9bfc-f954fc46f6bd/operations/d0a635ce-322f-49e1-9bfc-f954fc46f6be",
  "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"
    }
  }
}