GET
# Airbnb Listing Calendar API

Get real-time calendar availability and stay requirements for any Airbnb listing.

## Overview

#### Real-time Availability

Calendar data is fetched in real-time from Airbnb. Availability and prices may change frequently.

The Airbnb Calendar endpoint returns per-day availability for up to 12 months, including minimum night requirements and check-in eligibility. Perfect for building availability calendars and checking booking windows.

### Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/{listing\_id}/calendar 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| listing\_id | string | Required | Airbnb listing ID (path parameter). Use decimal digits as a string in client code to preserve long IDs. |
| months | integer | Optional | Number of months to fetch (1-12, default: 12) |

## Response Structure

### Calendar Data

- `months` - Array of month objects with daily availability
- `date` - Date in YYYY-MM-DD format
- `available` - Whether the day is available for booking
- `available_for_checkin` - Whether guests can check in on this date
- `bookable` - Whether the date can be booked
- `min_nights` - Minimum nights required for check-in on this date

Request

```curl
curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22120898/calendar?months=3" \
  -H "x-api-key: YOUR_API_KEY"
```

Response

```json
{
  "success": true,
  "listing_id": "22120898",
  "months": [
    {
      "month": 3,
      "year": 2026,
      "days": [
        {
          "date": "2026-03-06",
          "available": true,
          "available_for_checkin": true,
          "bookable": true,
          "min_nights": 2
        },
        {
          "date": "2026-03-07",
          "available": false,
          "available_for_checkin": false,
          "bookable": false,
          "min_nights": null
        }
      ]
    }
  ]
}
```

```json
{
  "type": "https://api.stayapi.com/errors/upstream-error",
  "title": "Upstream Error",
  "status": 502,
  "detail": "The upstream service could not complete the request.",
  "error_code": "UPSTREAM_ERROR",
  "provider": "airbnb"
}
```