Docs/API Reference/Availability

Get availability calendar for a property

Availability · GET /v1/availability/:propertyId

Get availability calendar for a property

GET/v1/availability/:propertyId

Note

The listing's own calendar — one per listing, the same whichever channels it is on. `price` is the listing's price before any channel markup: a $200 night with a 35% Airbnb markup is sold on Airbnb for $270 while this returns 200. Markups: GET/PUT /v1/listings/{id}/markups. What a channel holds right now: read the channel (GET /v1/channels/booking/availability, GET /v1/channels/airbnb/listings/{id}/availability).

Request

curl https://api.repull.dev/v1/availability/123?from=2026-06-01&to=2026-06-05 \
  -H "Authorization: Bearer $REPULL_API_KEY"

Response

{
  "propertyId": "123",
  "currency": "USD",
  "days": [
    {
      "date": "2026-06-01",
      "available": true,
      "price": 0,
      "minNights": 0
    }
  ],
  "coverage": {
    "requestedDays": 0,
    "coveredDays": 0,
    "missingDates": []
  }
}

Captured from a real response. Regenerated on every release, and CI fails if this shape stops matching the API.

Query Parameters

fromdateRequired

First night, inclusive (YYYY-MM-DD)

todateRequired

Last night, inclusive (YYYY-MM-DD)

AI