Sign in

v1

latestOpenAPI 3.0.0MIT2026-08-043290199.3 KB
Listings

Deactivate a listing

Deactivate listing API allows you to deactivate a listing. A listing is deactivated when it doesn't have an ask or when it contains an expired ask.

put/selling/listings/{listingId}/deactivate

Path parameters

listingIdstring required

Unique ID for this listing

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