get_tour_availability - brightplace Developer Docs

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"
  }
}

Field	Type	Required	Notes
`listing_id`	string	Yes	A listing snapshot id returned by `search_listings`.
`date_range.start`	date	No	ISO date.
`date_range.end`	date	No	ISO 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"
    }
  ]
}

Status	Meaning
`available`	One or more slots are available.
`no_slots`	The provider was checked but had no matching slots.
`tours_not_available`	Tours are not available for the listing.

Unknown listing ids return LISTING_NOT_FOUND.