Suumer

Things to do on one day near one US town (trivia, live music, karaoke, comedy, games, markets, talks and more), each checked against the page it came from. Give the town the person asked about ("Denver, CO", "Tampa, FL" or "Sacramento, CA") or a 5-digit ZIP, a date, and optionally a kind of event. With no town, the rough town the app shares is used, if it shares one. Read-only: it changes nothing. US events only, at most 25 per call, soonest first. Each result has its own Suumer page to cite (suumerPage), and the original source page when we can show it.

{
  "type": "object",
  "properties": {
    "town": {
      "type": "string",
      "description": "The US town and state the person asked about, like \"Denver, CO\", \"Tampa, FL\" or \"Sacramento, CA\", or a 5-digit ZIP code. Leave it out to use the rough town the app shares.",
      "maxLength": 80
    },
    "date": {
      "type": "string",
      "description": "The day, written YYYY-MM-DD. Leave it out for today in that town.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "kind": {
      "type": "string",
      "description": "Kind of event. Leave it out (or \"all\") for everything. live_music covers concerts, bands, orchestras and choirs.",
      "enum": [
        "all",
        "trivia",
        "karaoke",
        "live_music",
        "dj_set",
        "local_band",
        "singer_songwriter",
        "music_jam",
        "drum_circle",
        "percussion_playground",
        "family_concert",
        "open_mic",
        "cultural_showcase",
        "film_concert",
        "music_talk",
        "music_learning",
        "darts",
        "pool",
        "games",
        "social_game",
        "puzzle_games",
        "robot_games",
        "mixed_games",
        "learning_games",
        "building_play",
        "board_games",
        "mahjong",
        "chess",
        "card_games",
        "bingo",
        "loteria",
        "video_games",
        "video_game_tournament",
        "accessible_games",
        "tabletop_roleplaying",
        "food_drink",
        "food_tasting",
        "food_skills",
        "sports_fitness",
        "road_race",
        "roller_skating",
        "college_football",
        "college_volleyball",
        "college_soccer",
        "basketball_tournament",
        "softball_tournament",
        "airshow",
        "fan_bar",
        "fan_watch_party",
        "comedy",
        "stand_up_comedy",
        "sketch_comedy",
        "improv_comedy",
        "talks_ideas",
        "public_lecture",
        "lecture_series",
        "public_debate",
        "author_talk",
        "choral_music",
        "classical_music",
        "chamber_orchestra",
        "symphony_orchestra",
        "chamber_music",
        "theater",
        "high_school_play",
        "community_play",
        "community_musical",
        "high_school_musical",
        "college_play",
        "college_musical",
        "puppet_theater",
        "dance_performance",
        "film_screening",
        "outdoor_movie",
        "arts_night",
        "arts",
        "block_party",
        "sales",
        "garage_sale",
        "yard_sale",
        "flea_market",
        "community",
        "family",
        "pets",
        "general_trivia",
        "music_trivia",
        "themed_trivia",
        "survey_game",
        "jeopardy_style_trivia",
        "music_bingo",
        "game_night",
        "online",
        "dj",
        "dancing",
        "drag",
        "tastings",
        "markets",
        "sports",
        "fitness",
        "kids",
        "festivals",
        "film",
        "movie_times",
        "fitness_class",
        "market",
        "festival"
      ]
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "town": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "total": {
      "type": "integer"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "suumerPage": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "suumerPage"
        ]
      }
    },
    "moreUrl": {
      "type": "string"
    }
  },
  "required": [
    "town",
    "date",
    "kind",
    "total",
    "events",
    "moreUrl"
  ]
}

Use when the person says a Suumer listing is wrong (the time changed, it was cancelled or moved, the place is wrong, it is not open to the public) and wants Suumer told, or agrees when you offer. Sends one report to Suumer's review queue holding only the listing and which part is wrong, picked from a fixed list: no note, name, email or account is sent or kept. A person at Suumer checks the listing against its source; nothing on the listing changes by itself. Take the listing from the suumerPage of a find_events result. The same report sent twice in a day counts once.

{
  "type": "object",
  "properties": {
    "listing": {
      "type": "string",
      "description": "The listing's Suumer page (https://suumer.com/e/...) or its id.",
      "maxLength": 300
    },
    "problem": {
      "type": "string",
      "description": "Which part is wrong: wrong_facts = the name, time, or other facts are wrong; cancelled_or_moved = it was cancelled or moved; wrong_place = the place or address is wrong; not_a_public_event = it is not a public event; other = something else is wrong.",
      "enum": [
        "wrong_facts",
        "cancelled_or_moved",
        "wrong_place",
        "not_a_public_event",
        "other"
      ]
    }
  },
  "required": [
    "listing",
    "problem"
  ],
  "additionalProperties": false
}