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

# Batch listings update

`POST /selling/batch/update-listing`

Batch update listings API allows a user to update 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

- BatchUpdateListingInput
  - `items` UpdateBatchListingRequestItem[], required — An array of items that should be associated with the batch
    - `listingId` string, required — Unique listing ID that needs to be updated
    - `amount` string — The amount this Listing is updated to
    - `expiresAt` string — UTC timestamp representing the Listing expiry date that is being updated to
    - `currencyCode` string — The currency this Listing is updated to<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"
    - `active` boolean — Flag used to indicate that the listing should be active or not

## Response `200`

Ok

- BatchUpdateListingResponse
  - `batchId` string, required — Unique Batch ID
  - `status` string, required — The status of the batch
  - `completedAt` string, nullable, required — When this batch was last completed in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `createdAt` string, required — When this batch was last created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `updatedAt` string, required — When this batch was last 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)