Events Search

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

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

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

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