Skip to main content
get_tour_availability checks available tour slots for one listing snapshot.

​
Input

{
  "listing_id": "listing-record-id",
  "date_range": {
    "start": "2026-07-01",
    "end": "2026-07-14"
  }
}
FieldTypeRequiredNotes
listing_idstringYesA listing snapshot id returned by search_listings.
date_range.startdateNoISO date.
date_range.enddateNoISO date on or after start.
When date_range is omitted, BrightPlace checks a 14-day window starting on the current date.

​
Output

{
  "availability_status": "available",
  "message": null,
  "slots": [
    {
      "slot_id": "slot-id-from-provider",
      "starts_at": "2026-07-02T10:00:00Z",
      "ends_at": "2026-07-02T10:30:00Z",
      "tour_type": "self_guided"
    }
  ]
}
StatusMeaning
availableOne or more slots are available.
no_slotsThe provider was checked but had no matching slots.
tours_not_availableTours are not available for the listing.
Unknown listing ids return LISTING_NOT_FOUND.