---
title: "GET /district/{district_key}/events"
method: GET
path: "/district/{district_key}/events"
tags: ["district", "event"]
---

# GET /district/{district_key}/events

`GET /district/{district_key}/events`

Gets a list of events in the given district.

## Path parameters

- `district_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- Event[]
  - `key` string, required — 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` string, required — Official name of event on record either provided by FIRST or organizers of offseason event.
  - `event_code` string, required — Event short code, as provided by FIRST.
  - `event_type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 99 | 100 | -1, required — Event Type. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/event_type.py for definitions.
  - `district` District, required
    - `abbreviation` string, required — The short identifier for the district.
    - `display_name` string, required — The long name for the district.
    - `key` string, required — Key for this district, e.g. `2016ne`.
    - `year` integer, required — Year this district participated.
    - `official_advancement_counts` object, required — The number of teams advancing to DCMP and CMP from this district, as specified in the FIRST manual.
      - `dcmp` integer, required — Number of teams advancing to the District Championship.
      - `cmp` integer, required — Number of teams advancing to the Championship.
  - `city` string, nullable, required — City, town, village, etc. the event is located in.
  - `state_prov` string, nullable, required — State or Province the event is located in.
  - `country` string, nullable, required — Country the event is located in.
  - `start_date` string, date, required — Event start date in `yyyy-mm-dd` format.
  - `end_date` string, date, required — Event end date in `yyyy-mm-dd` format.
  - `year` integer, required — Year the event data is for.
  - `short_name` string, nullable, required — Same as `name` but doesn't include event specifiers, such as 'Regional' or 'District'. May be null.
  - `event_type_string` string, required — Event Type, eg Regional, District, or Offseason.
  - `week` integer, nullable, required — Week of the event relative to the first official season event, zero-indexed. Only valid for Regionals, Districts, and District Championships. Null otherwise. (Eg. A season with a week 0 'preseason' event does not count, and week 1 events will show 0 here. Seasons with a week 0.5 regional event will show week 0 for those event(s) and week 1 for week 1 events and so on.)
  - `address` string, nullable, required — Address of the event's venue, if available.
  - `postal_code` string, nullable, required — Postal code from the event address.
  - `gmaps_place_id` string, nullable, required — Google Maps Place ID for the event address. Will be NULL, for future development.
  - `gmaps_url` string, url, nullable, required — Link to address location on Google Maps. Will be NULL, for future development.
  - `lat` number, double, nullable, required — Latitude for the event address. Will be NULL, for future development.
  - `lng` number, double, nullable, required — Longitude for the event address. Will be NULL, for future development.
  - `location_name` string, nullable, required — Name of the location at the address for the event, eg. Blue Alliance High School.
  - `timezone` string, nullable, required — IANA Timezone identifier.
  - `website` string, nullable, required — The event's website, if any.
  - `first_event_id` string, nullable, required — The FIRST internal Event ID, used to link to the event on the FRC webpage.
  - `first_event_code` string, nullable, required — Public facing event code used by FIRST (on frc-events.firstinspires.org, for example)
  - `webcasts` Webcast[], required
    - `type` 'youtube' | 'twitch' | 'ustream' | 'iframe' | 'html5' | 'rtmp' | 'livestream' | 'direct_link' | 'mms' | 'justin' | 'stemtv' | 'dacast', required — Type of webcast, typically descriptive of the streaming provider.
    - `channel` string, required — Type specific channel information. May be the YouTube stream, or Twitch channel name. In the case of iframe types, contains HTML to embed the stream in an HTML iframe.
    - `date` string, nullable — The date for the webcast in `yyyy-mm-dd` format. May be null.
    - `file` string, nullable — File identification as may be required for some types. May be null.
    - `status` 'unknown' | 'online' | 'offline' — Online status of a webcast. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/webcast_status.py for full definitions.
    - `stream_title` string, nullable — The title of the stream from the streaming provider. May be null.
    - `viewer_count` integer, nullable — The current viewer count from the streaming provider. May be null.
  - `division_keys` string[], required — An array of event keys for the divisions at this event.
  - `parent_event_key` string, nullable, required — The TBA Event key that represents the event's parent. Used to link back to the event from a division event. It is also the inverse relation of `divison_keys`.
  - `playoff_type` 1 | 0 | 2 | 9 | 3 | 4 | 5 | 10 | 11 | 6 | 7 | 8, required — Playoff bracket format. See https://github.com/the-blue-alliance/the-blue-alliance/blob/main/src/backend/common/consts/playoff_type.py for definitions.
  - `playoff_type_string` string, nullable, required — String representation of the `playoff_type`, or null.
  - `remap_teams` object, nullable, required — Map of temporary "off-season demo" team numbers to pre-rookie and B teams. Both keys and values are team keys in the format 'frc####'. Key is the old team key ('frc' + numeric only), value is the new team key ('frc' + numeric + may include a letter suffix).

## Other responses

- `304` — Not Modified - Use Local Cached Value
- `401` — Authorization information is missing or invalid.
- `404` — Not Found

---

[API](https://skmtc.net/thebluealliance/apis/the-blue-alliance-api-v3.md) · [All operations](https://skmtc.net/thebluealliance/apis/the-blue-alliance-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thebluealliance/the-blue-alliance-api-v3/revisions/b9b0f447dbcb/schema)