---
title: "Summarize stay availability across a collection"
description: "One aggregate read answering which published rentals can host a stay, so results pages never download every unit's full calendar. Fit is computed server-side from Kismet's synchronized calendar plane with the same rules Kismet's own booking surfaces enforce: every occupied night open, check-in allowed on arrival, check-out allowed on the departure morning, and the arrival night's minimum stay satisfied. `available` is a tri-state: true (fits every synced rule), false (a synced rule rejects it), null (the synced calendar does not cover the stay — treat as unknown, never as closed; drill into `getVacationRentalCalendar`). Open rows may carry `display` — Kismet's display-pricing convention: required fees folded into the before-tax stay subtotal and divided across nights (\"$X / night + tax\"; taxes are revealed at checkout), computed by the same engine Kismet checkout uses with `guests` applied to per-guest fees. Absent `display` means \"price at the next step\", never zero. This is still not a bookable quote: taxes, payment, and checkout are out of scope."
---

`GET /v1/developer/collections/{collection}/vacation-rentals/availability`

**Operation ID:** `getCollectionAvailability`

One aggregate read answering which published rentals can host a stay, so results pages never download every unit's full calendar. Fit is computed server-side from Kismet's synchronized calendar plane with the same rules Kismet's own booking surfaces enforce: every occupied night open, check-in allowed on arrival, check-out allowed on the departure morning, and the arrival night's minimum stay satisfied. `available` is a tri-state: true (fits every synced rule), false (a synced rule rejects it), null (the synced calendar does not cover the stay — treat as unknown, never as closed; drill into `getVacationRentalCalendar`). Open rows may carry `display` — Kismet's display-pricing convention: required fees folded into the before-tax stay subtotal and divided across nights ("$X / night + tax"; taxes are revealed at checkout), computed by the same engine Kismet checkout uses with `guests` applied to per-guest fees. Absent `display` means "price at the next step", never zero. This is still not a bookable quote: taxes, payment, and checkout are out of scope.

## Contract status

| Field | Value |
| --- | --- |
| Maturity | `beta` |
| Required capability | `rates.read` |
| Freshness class | `synced-commercial` |
| Quota cost | `1` |
| Operational owner | API + Booking Platform |

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential's installation grants; identifiers in the URL never grant access.

## Request parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `checkIn` | query | string | yes |  |
| `checkOut` | query | string | yes |  |
| `guests` | query | integer | no |  |
| `collection` | path | string | yes |  |

## Request body

This operation has no JSON request body.

## cURL

```sh
curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/collections/sand-sea-condos/vacation-rentals/availability" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Success. |
| 400 | Invalid request parameters or body. |
| 401 | Missing, invalid, expired, or inappropriate credential/session. |
| 403 | Credential lacks the required grant/capability, or an origin/CSRF check failed. |
| 429 | Rate limit or quota exceeded; inspect response metadata before retrying. |
| 503 | A required Kismet dependency is temporarily unavailable. |

### Success example

```json
{
  "data": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "slug": "sandbox-chalet",
      "available": true,
      "display": {
        "nightlyMinor": 30000,
        "totalBeforeTaxMinor": 90000,
        "currency": "USD"
      }
    },
    {
      "id": "33333333-3333-4333-8333-333333333333",
      "slug": "sandbox-bungalow",
      "available": false
    },
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "slug": "sandbox-cottage",
      "available": null
    }
  ],
  "meta": {
    "checkIn": "2026-08-01",
    "checkOut": "2026-08-04",
    "nights": 3,
    "guests": 2,
    "propertiesChecked": 3,
    "openCount": 1,
    "lastSyncedAt": "2026-07-01T00:00:00.000Z"
  }
}
```

## Machine-readable sources

- [This page as Markdown](/api/reference/get-collection-availability.md)
- [Developer API OpenAPI v0.7.0](/openapi.json)