Wullup Events

Use this when the user wants to find events in Germany: concerts, parties, club nights, festivals, open airs, workshops, markets or community events, in a city or near them, for a day, a weekend or a date range. Returns upcoming public events with date, venue, price and a wullup.com link. Do not use it for buying tickets, for events outside Germany, or for past events.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to match in the event title or venue, e.g. 'Techno', 'Jazz', 'Flohmarkt'. Omit for everything.",
      "type": "string",
      "maxLength": 200
    },
    "city": {
      "description": "Only when the user explicitly named a German city or town, e.g. München, Köln, Frankfurt am Main (English names like Munich or Cologne work too). Omit to use the user's approximate location.",
      "type": "string",
      "maxLength": 120
    },
    "when": {
      "description": "A quick date window. Ignored when `from` is given.",
      "type": "string",
      "enum": [
        "today",
        "tomorrow",
        "weekend"
      ]
    },
    "from": {
      "description": "First day to include, YYYY-MM-DD (German local date).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Last day to include, YYYY-MM-DD (German local date).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "category": {
      "type": "string",
      "enum": [
        "concerts-and-music",
        "party",
        "festivals",
        "open-air",
        "club-night",
        "workshops",
        "community",
        "markets",
        "other"
      ]
    },
    "price": {
      "description": "'free' for free entry only.",
      "type": "string",
      "enum": [
        "free",
        "paid"
      ]
    },
    "limit": {
      "default": 6,
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "language": {
      "default": "de",
      "description": "The language the user writes in: 'de' for German, 'en' for any other language. Sets the language of the event cards.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "startDate": {
            "type": "string"
          },
          "startTime": {
            "type": [
              "string",
              "null"
            ]
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "endTime": {
            "type": [
              "string",
              "null"
            ]
          },
          "venueName": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": "object",
            "properties": {
              "currency": {
                "type": "string"
              },
              "label": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "max": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "min": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "mode": {
                "type": "string",
                "enum": [
                  "free",
                  "paid",
                  "donation",
                  "unknown"
                ]
              }
            },
            "required": [
              "currency",
              "label",
              "max",
              "min",
              "mode"
            ],
            "additionalProperties": false
          },
          "adultsOnly": {
            "type": "boolean"
          },
          "url": {
            "type": "string"
          },
          "posterColor": {
            "type": "string"
          },
          "source": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "asOf": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "asOf",
                  "label",
                  "url"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "title",
          "startDate",
          "startTime",
          "endDate",
          "endTime",
          "venueName",
          "city",
          "category",
          "price",
          "adultsOnly",
          "url",
          "posterColor",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "required": [
    "events",
    "language"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}