Listing available stays — Airbnb

airbnb.listing.available_stays

Find calendar-valid Airbnb stays and confirm availability and pricing

POST /v1/operations/airbnb.listing.available_stays

Headers

Authorization: Bearer YOUR_CONNECTOR_TOKEN
Content-Type: application/json

Inputs

Parameter	Example type	Example value
listing_id	string	"123456789"
stay	object	{"checkin":"2026-10-01","checkout":"2026-11-01","adults":2,"currency":"GBP"}
nights	number	3
limit	number	3

Example input

{
  "listing_id": "123456789",
  "stay": {
    "checkin": "2026-10-01",
    "checkout": "2026-11-01",
    "adults": 2,
    "currency": "GBP"
  },
  "nights": 3,
  "limit": 3
}

Illustrative response for the example input. Availability, prices and result order vary. Replace example references and URLs with values returned by your own requests.

Example response

{
  "listing_id": "123",
  "items": [
    {
      "stay": {
        "checkin": "2026-10-19",
        "checkout": "2026-10-21",
        "adults": 2,
        "children": 0,
        "infants": 0,
        "pets": 0,
        "currency": "GBP"
      },
      "booking": {
        "availability": {
          "isAvailable": true
        },
        "structuredDisplayPrice": {
          "primaryLine": {
            "price": "£200",
            "qualifier": "total"
          }
        }
      }
    }
  ],
  "checked_candidates": 1,
  "exhausted": false,
  "availability": {
    "calendar_months": []
  }
}

Open JSON schema

Input schema

{
  "$id": "https://useajar.com/schemas/airbnb/listing-available-stays.input.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "limit": {
      "maximum": 5,
      "minimum": 1,
      "type": "integer"
    },
    "listing_id": {
      "pattern": "^[0-9]{1,30}$",
      "type": "string"
    },
    "nights": {
      "maximum": 90,
      "minimum": 1,
      "type": "integer"
    },
    "stay": {
      "additionalProperties": false,
      "description": "Search window: checkin is the earliest arrival and checkout the latest departure.",
      "properties": {
        "adults": {
          "maximum": 16,
          "minimum": 1,
          "type": "integer"
        },
        "checkin": {
          "format": "date",
          "type": "string"
        },
        "checkout": {
          "format": "date",
          "type": "string"
        },
        "children": {
          "maximum": 15,
          "minimum": 0,
          "type": "integer"
        },
        "currency": {
          "description": "Airbnb display currency for prices and price filters; GBP by default. No local currency conversion.",
          "enum": [
            "AED",
            "AUD",
            "BRL",
            "BGN",
            "CAD",
            "CHF",
            "CLP",
            "CNY",
            "COP",
            "CRC",
            "CZK",
            "DKK",
            "EGP",
            "EUR",
            "GBP",
            "GHS",
            "HKD",
            "HUF",
            "IDR",
            "ILS",
            "INR",
            "JPY",
            "KES",
            "KRW",
            "KZT",
            "MAD",
            "MXN",
            "MYR",
            "NOK",
            "NZD",
            "PEN",
            "PLN",
            "PHP",
            "QAR",
            "RON",
            "SAR",
            "SEK",
            "SGD",
            "THB",
            "TRY",
            "TWD",
            "UAH",
            "UGX",
            "USD",
            "UYU",
            "VND",
            "ZAR"
          ],
          "type": "string"
        },
        "infants": {
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        },
        "pets": {
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "checkin",
        "checkout"
      ],
      "type": "object"
    }
  },
  "required": [
    "listing_id",
    "stay",
    "nights"
  ],
  "type": "object"
}