---
title: "Deactivate a listing"
method: PUT
path: "/selling/listings/{listingId}/deactivate"
tags: ["Listings"]
---

# Deactivate a listing

`PUT /selling/listings/{listingId}/deactivate`

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.

## Path parameters

- `listingId` string, required

## Response `200`

- ListingAsyncOperationResponse
  - `listingId` string, required — Unique ID for this listing
  - `operationId` string, 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
  - `operationUrl` string, 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
  - `createdAt` string, required — When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `updatedAt` string, required — When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `changes` ListingOperationsChangesDiff, required — JSON metadata object which include the changes of current listing
    - `additions` AdditionsRecursivePartialListingChangeableFields, required — The additions of current listing
    - `updates` UpdatesRecursivePartialListingChangeableFields, required — The updates of current listing
    - `removals` RemovalsRecursivePartialListingChangeableFields, required — The removals of current listing
  - `error` string, nullable — Error message if the creation failed

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/stockx/apis/stockx-public-api.md) · [All operations](https://skmtc.net/stockx/apis/stockx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockx/stockx-public-api/versions/5b4ba84182d7/schema)