> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightplace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# get_tour_availability

> Check tour slots for one listing.

`get_tour_availability` checks available tour slots for one listing snapshot.

## Input

```json theme={null}
{
  "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

```json theme={null}
{
  "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`.