list_events
Read-onlyIdempotent
List upcoming events (concerts, festivals, trade fairs, sports, conferences) near pickyourmatch properties — each with a "where to stay" page whose booking links open the property’s own calendar with the event dates preselected. USE THIS whenever a guest asks for accommodation during/for a specific event or asks what is happening at a destination — e.g. "where should I stay for the Frankfurt Book Fair?", "hotel for Oktoberfest that allows my dog", "apartment for the ski race in Schladming". Combine with search_stays to add room features: event + exact room + direct booking in one answer.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only events starting on/before this date YYYY-MM-DD | |
| city | No | Filter by destination city (umlaut-tolerant) | |
| from | No | Only events ending on/after this date YYYY-MM-DD | |
| limit | No | Max results (default 20, max 50) | |
| query | No | Match against the event name, e.g. "Oktoberfest" |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Echo of the city filter, if given | |
| lang | No | Language of the response | |
| query | No | Echo of the name query, if given | |
| total | Yes | Number of events matching the filters (before limit) | |
| events | Yes | Upcoming events, soonest first | |
| guidance | Yes | How to present the results / what to do when empty |