---
title: "Batch listings deletion"
method: POST
path: "/selling/batch/delete-listing"
tags: ["Batch"]
---

# Batch listings deletion

`POST /selling/batch/delete-listing`

Batch delete listings API allows a user to delete up to 100 individual listings in a single API call.
This API is asynchronous in nature and will return a batchId that you would need to poll using the polling APIs described later.

## Request body

- BatchDeleteListingInput
  - `items` DeleteBatchListingRequestItem[], required — An array of IDs that should be associated with the batch
    - `listingId` string, required — Unique listing ID that needs to be deleted

## Response `200`

Ok

- BatchDeleteListingResponse
  - `batchId` string, required — Unique Batch ID
  - `status` string, required — The status of the batch
  - `completedAt` string, nullable, required — When this batch was completed in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `createdAt` string, required — When this batch was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `updatedAt` string, required — When this batch was updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `totalItems` number, double, required — Total number of items in this batch
  - `itemStatuses` BatchStatusCounts, required — The number of items in this batch grouped by their statuses. This is a short-hand way to quickly introspect how many items are still enqued, how many succeeded or how many failed in a batch.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `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)