events-search

{'type': 'object', 'required': ['event_id'], 'properties': {'event_id': {'type': 'integer', 'description': 'Performance identifier - an event_id value from search_events or list_performances results.'}}}

{'type': 'object', 'required': ['artist_id'], 'properties': {'artist_id': {'type': 'integer', 'description': 'Title identifier - the artist_id field from search_events results.'}}}

{'type': 'object', 'required': ['artist_id'], 'properties': {'city': {'type': 'string', 'default': None, 'description': 'City name filter (exact match, case-insensitive, diacritics required), e.g. "Warszawa".'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number, starting at 1.'}, 'date_to': {'type': 'string', 'format': 'date', 'default': None, 'description': 'Latest performance date (YYYY-MM-DD), inclusive.'}, 'artist_id': {'type': 'integer', 'description': 'Title identifier - the artist_id field from search_events results.'}, 'date_from': {'type': 'string', 'format': 'date', 'default': None, 'description': 'Earliest performance date (YYYY-MM-DD). Defaults to today.'}, 'items_per_page': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Performances per page. Defaults to 20.'}}}

{'type': 'object', 'properties': {'city': {'type': 'string', 'default': None, 'description': 'City name filter (exact match, case-insensitive, diacritics required), e.g. "Warszawa".'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number, starting at 1. Compare "page" with "total_pages" or read "has_more" to know whether more results exist.'}, 'sort': {'enum': ['relevance', 'date_asc', 'price_asc', 'rating_desc'], 'type': 'string', 'default': 'relevance', 'description': 'Result ordering. "date_asc" sorts by the performance date, "price_asc" by its cheapest ticket, "rating_desc" by the average rating of the title. Defaults to "relevance".'}, 'query': {'type': 'string', 'default': None, 'description': 'Search phrase: event name, performer or kind of event. Typo-tolerant. Use Polish terms when possible.'}, 'date_to': {'type': 'string', 'format': 'date', 'default': None, 'description': 'Latest performance date (YYYY-MM-DD).'}, 'category': {'type': 'string', 'default': None, 'description': 'Event category name filter (exact match), e.g. "koncert", "spektakl", "kabaret".'}, 'date_from': {'type': 'string', 'format': 'date', 'default': None, 'description': 'Earliest performance date (YYYY-MM-DD). Defaults to today - past performances are never returned.'}, 'max_price': {'type': 'number', 'default': None, 'minimum': 0, 'description': 'Maximum price of the cheapest ticket for the performance, in PLN (not in grosze).'}, 'min_rating': {'type': 'number', 'default': None, 'maximum': 5, 'minimum': 1, 'description': 'Minimum average user rating of the title (1-5 stars).'}, 'items_per_page': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'Titles per page. Defaults to 10.'}}}