action thebluealliance_get_events_by_year_simple {
  label: "getEventsByYearSimple"
  description: "Gets a short-form list of events in the given year."
  provider: thebluealliance
  method: GET
  path: "/events/{year}/simple"
  encoding: json
  output: {
    type: "array"
    items: {
      type: "object"
      required: ["end_date", "event_code", "event_type", "key", "name", "start_date", "year"]
      properties: {
        city: {
          type: "string"
          description: "City, town, village, etc. the event is located in."
        }
        country: {
          type: "string"
          description: "Country the event is located in."
        }
        district: {
          type: "object"
          required: ["abbreviation", "display_name", "key", "year"]
          properties: {
            abbreviation: {
              type: "string"
              description: "The short identifier for the district."
            }
            display_name: {
              type: "string"
              description: "The long name for the district."
            }
            key: {
              type: "string"
              description: "Key for this district, e.g. `2016ne`."
            }
            year: {
              type: "integer"
              description: "Year this district participated."
            }
          }
        }
        end_date: {
          type: "string"
          format: "date"
          description: "Event end date in `yyyy-mm-dd` format."
        }
        event_code: {
          type: "string"
          description: "Event short code, as provided by FIRST."
        }
        event_type: {
          type: "integer"
          description: "Event Type, as defined here: https://github.com/the-blue-alliance/the-blue-alliance/blob/master/consts/event_type.py#L2"
        }
        key: {
          type: "string"
          description: "TBA event key with the format yyyy[EVENT_CODE], where yyyy is the year, and EVENT_CODE is the event code of the event."
        }
        name: {
          type: "string"
          description: "Official name of event on record either provided by FIRST or organizers of offseason event."
        }
        start_date: {
          type: "string"
          format: "date"
          description: "Event start date in `yyyy-mm-dd` format."
        }
        state_prov: {
          type: "string"
          description: "State or Province the event is located in."
        }
        year: {
          type: "integer"
          description: "Year the event data is for."
        }
      }
    }
  }
}