---
title: "Get the synced nightly calendar for a vacation rental"
description: "Per-night availability and indicative nightly rates from Kismet's synchronized calendar plane for a bounded date window (max 90 days, today onward). `meta.lastSyncedAt` communicates recency. This is never a bookable quote: totals, fees, taxes, and checkout are out of scope. `nightlyRate` is null when the connected source withholds the rate; a night is bookable only when `available` is true."
---

`GET /v1/developer/vacation-rentals/{vacationRental}/calendar`

**Operation ID:** `getVacationRentalCalendar`

Per-night availability and indicative nightly rates from Kismet's synchronized calendar plane for a bounded date window (max 90 days, today onward). `meta.lastSyncedAt` communicates recency. This is never a bookable quote: totals, fees, taxes, and checkout are out of scope. `nightlyRate` is null when the connected source withholds the rate; a night is bookable only when `available` is true.

## 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 |
| --- | --- | --- | --- | --- |
| `start` | query | string | yes |  |
| `end` | query | string | yes |  |
| `vacationRental` | path | string | yes |  |

## Request body

This operation has no JSON request body.

## cURL

```sh
curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/vacation-rentals/sand-sea-110/calendar" \
  --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": [
    {
      "date": "2026-08-01",
      "available": true,
      "nightlyRate": {
        "amountMinor": 18900,
        "currency": "USD"
      },
      "minStay": 2,
      "checkInAllowed": true,
      "checkOutAllowed": true
    },
    {
      "date": "2026-08-02",
      "available": false,
      "nightlyRate": null,
      "checkInAllowed": false,
      "checkOutAllowed": true
    }
  ],
  "meta": {
    "start": "2026-08-01",
    "end": "2026-08-02",
    "lastSyncedAt": "2026-07-01T00:00:00.000Z"
  }
}
```

## Machine-readable sources

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