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

# Retrieve the optimized calendar for a single listing

`GET /availability-pricing/api/calendar/listings/minified/{listingId}`

## Request

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

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

**View Parameter Behavior:**
- `view=compact` (default): Returns minimal data without `blockIds` array and detailed `blocks` object for better performance
- `view=full`: Returns complete data including `blockIds` array for each calendar day and detailed `blocks` object with full block information

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

- `listingId` string, required

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `includeAllotment` boolean
- `ignoreInactiveChildAllotment` boolean
- `ignoreUnlistedChildAllotment` boolean
- `view` 'compact' | 'full'

## Response `200`

Optimized calendar with available/unavailable dates. When view=compact, returns minimal data without blockIds and detailed blocks. When view=full, includes blockIds array and detailed blocks object. Returns only the data object containing the days information.

- object
  - `days` object
    - `listingId` string
    - `startDate` string: Start date with format YYYY-MM-DD
    - `endDate` string: End date with format YYYY-MM-DD
    - `currency` string: Listing's currency value.
    - `calendar` object[]
      - `date` string: Date with format YYYY-MM-DD
      - `price` number: Price in the listing's currency.
      - `minNights` number: Min nights value.
      - `blocks` object: Block information for the date. Only includes block types with true values.
      - `isBasePrice` boolean: Flag which shows whether listing is set to base price.
      - `isBaseMinNights` boolean: Flag which shows whether listing is set to base min night.
      - `requestToBook` boolean: Request to book flag
      - `cta` boolean: Closed To Arrival value
      - `ctd` boolean: Closed To Departure value
      - `blockIds` string[]: Array of block IDs for this date (only present when view=full)
    - `blocks` object: Detailed block information (only present when view=full)

## 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/minified/:listingId/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)