---
title: "Retrieve calendars for multiple listings"
method: GET
path: "/availability-pricing/api/calendar/listings"
tags: ["Calendar"]
---

# Retrieve calendars for multiple listings

`GET /availability-pricing/api/calendar/listings`

Use this endpoint to retrieve calendar availability and pricing for multiple listings according to a date range.

## Query parameters

- `listingIds` string, required
- `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.

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)