---
title: "Unreserve inventory items by batch."
method: PUT
path: "/v1/Products/LimitedInventory/UnreserveByBatch"
tags: ["Products"]
---

# Unreserve inventory items by batch.

`PUT /v1/Products/LimitedInventory/UnreserveByBatch`

## Request

- Base URL: `https://api.domain.com.au`
- URL: `https://api.domain.com.au/v1/Products/LimitedInventory/UnreserveByBatch`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://auth.domain.com.au/v1/connect/authorize`
    - Client credentials
    - Token URL: `https://auth.domain.com.au/v1/connect/token` scopes: `api_agencies_write`
- TypeScript: <https://skmtc.dev/domain/apis/domain-public-api/docs/v1/Products/LimitedInventory/UnreserveByBatch/put.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- BookingV2ApiV1UnreserveInventoryByBatchRequest
  - `agencyId` integer
  - `cancelledBy` string, required
  - `reservationIds` integer[], nullable

## Response `200`

All batch unreservation successful

- BookingV2ApiV1UnreserveInventoryByBatchResponse
  - `results` BookingV2ApiV1UnreserveResponse[], nullable
    - `error` string, nullable
    - `reservationId` integer
    - `agencyId` integer
  - `summary` BookingV2ApiV1BatchSummaryResponse
    - `requested` integer
    - `succeeded` integer
    - `failed` integer

## Other responses

- `207`: Some unreservation failed
- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unreserve by batch processed without success
- `500`: All batch unreservation failed or internal server error

## Changes

- **2026-05-08** `7130302fb268`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/domain/apis/domain-public-api/changes/v1/Products/LimitedInventory/UnreserveByBatch/put.md)

---

[API](https://skmtc.dev/domain/apis/domain-public-api.md) - [All operations](https://skmtc.dev/domain/apis/domain-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domain/apis/domain-public-api/revisions/133015c6842c?raw)