---
title: "Get Airbnb room calendar"
method: GET
path: "/airbnb/room/{id}/calendar"
tags: ["Airbnb"]
---

# Get Airbnb room calendar

`GET /airbnb/room/{id}/calendar`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/airbnb/room/{id}/calendar`
- Auth: API key in header `x-api-key`

Returns the public availability calendar for one Airbnb room, grouped by month. Each day carries its date, whether it is available and bookable, whether it can be a check-in or check-out day, and the minimum and maximum nights. Months are returned only when Airbnb exposes them for the listing.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AirbnbCalendarResponse
  - `id` string: Airbnb room id the calendar belongs to.
  - `months` AirbnbCalendarMonth[]: Availability by month.
    - `days` AirbnbCalendarDay[]: One entry per day of the month.
      - `available` boolean: True when the night is free.
      - `available_for_checkin` boolean: True when a stay can start on this day.
      - `available_for_checkout` boolean: True when a stay can end on this day.
      - `bookable` boolean: True when the day can be booked.
      - `date` string: Calendar date (YYYY-MM-DD).
      - `max_nights` integer: Maximum stay, in nights, for a booking that starts on this day.
      - `min_nights` integer: Minimum stay, in nights, for a booking that starts on this day.
    - `month` string: Month, as a number from 1 to 12 or a month name.
    - `year` integer: Four-digit year.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)