---
title: "Retrieve the calendar for a single listing"
method: GET
path: "/availability-pricing/api/calendar/listings/{id}"
tags: ["Calendar"]
---

# Retrieve the calendar for a single listing

`GET /availability-pricing/api/calendar/listings/{id}`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/availability-pricing/api/calendar/listings/{id}`
- Auth: API key in header `authorization`

Use this endpoint to retrieve daily calendar availability and pricing for a given listing ID and date range.

IMPORTANT: Multi-unit calendar availability is determined by unit allotment, not its `status` field. To calculate if a multi-unit has availability, use the following formula:

```
const isAvailable = _.isNumber(currentDay.allotment)?
currentDay.allotment > 0 : currentDay.status === 'available';
```

## Path parameters

- `id` string, required

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `includeAllotment` boolean
- `ignoreInactiveChildAllotment` boolean
- `ignoreUnlistedChildAllotment` boolean

## Response `200`

Calendar with available/unavailable dates

- object
  - `date` string: Date with format YYYY-MM-DD
  - `listingId` string
  - `currency` string: Listing's currency value.
  - `price` number: Price in the listing's currency.
  - `isBasePrice` boolean: Flag which shows whether listing is set to base price.
  - `minNights` number: Min nights value.
  - `isBaseMinNights` boolean: Flag which shows whether listing is set to base min night.
  - `status` string: Status value, enum: available, unavailable, booked, reserved.
  - `allotment` number: Allotment value for parent listing.
  - `blocks` object
  - `blockRefs` string[]
  - `reservationId` string
  - `reservation` object
  - `cta` boolean: Closed To Arrival value
  - `ctd` boolean: Closed To Departure value

## Other responses

- `404`: Listing Not Found
- `422`: Validation Error
- `500`: Unhandled exception. Something went wrong on server.

## Changes

- **2026-11-03** `3122b8618183`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/availability-pricing/api/calendar/listings/:id/get.md)

---

[API](https://skmtc.dev/guesty/apis/guesty-open-api.md) - [All operations](https://skmtc.dev/guesty/apis/guesty-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/guesty/apis/guesty-open-api/revisions/3122b8618183?raw)