---
title: "Batch check live inventory availability"
method: POST
path: "/availability/batch-check"
tags: ["Availability"]
---

# Batch check live inventory availability

`POST /availability/batch-check`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/availability/batch-check`
- Auth: none declared

Return live Total Parks inventory availability for up to 50 stays.

## Query parameters

- `country` 'AU' | 'NZ': ISO country code used to scope public property inventory.

## Headers

- `X-Conversion-Attempt-ID` string, nullable
- `API-Version` '1'

## Request body

- PlanningAvailabilityBatchCheckRequest: Batch of cache-only planning availability checks.
  - `checks` PlanningAvailabilityCheckRequest[], required: Availability checks to evaluate, capped at 50.
    - `property_id` integer, required: Internal property identifier.
    - `room_type_id` integer, nullable: Optional internal room type identifier.
    - `check_in` string, date, required: Check-in date.
    - `check_out` string, date, required: Check-out date; must be after check_in.
    - `adults` integer
    - `children` integer
    - `infants` integer
    - `accommodation_kind` 'site' | 'accommodation', nullable: Optional stay type filter.
    - `equipment_type` 'caravan' | 'campervan' | 'motorhome' | 'camp_trailer' | 'roof_top_tent' | 'tent' | 'swag' | 'car_ute' | 'fifth_wheeler' | 'boat_trailer', nullable: Canonical equipment type for RMS site compatibility.
    - `equipment_length_m` number, nullable: Rig length in metres for site fit checks.
    - `equipment_width_m` number, nullable: Optional rig width in metres for site fit checks.
    - `power_required` boolean, nullable: Whether the traveller requires a powered site.

## Response `200`

Successful Response

- SuccessPayload
  - `msg` string, required
  - `data` union
    - object
    - unknown[]
      - unknown
    - string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/totalparks/apis/total-parks-public-api.md) · [All operations](https://skmtc.dev/totalparks/apis/total-parks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/totalparks/apis/total-parks-public-api/revisions/dcb4c822e2c6?raw)