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

# Batch listings creation

`POST /selling/batch/create-listing`

Create a new batch of listings

## Request body

- BatchCreateListingInput
  - `items` CreateBatchListingRequestItem[], required — An array of items that should be associated with the batch
    - `inventoryType` string — The inventory this product is being listed in. If not provided, it will default to STANDARD.<br><br>Available values: "STANDARD", "DIRECT"
    - `active` boolean — Flag used to indicate that the listing should be active or not
    - `quantity` number, double, required — The total number of Listings that need to be created.
    - `currencyCode` string — The currency this Listing is being listed in. If not provided, it will default to USD.<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"
    - `variantId` string, required — Unique StockX variant ID that this Listing is being created for
    - `expiresAt` string — 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
    - `amount` string, required — The amount this Listing is being listed for

## Response `200`

Ok

- BatchCreateListingResponse
  - `batchId` string, required — Unique Batch ID
  - `status` string, required — The status of the batch
  - `completedAt` string, nullable, required — When the batch fully completed
  - `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 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)