---
title: "GET /district/{district_abbreviation}/insights"
method: GET
path: "/district/{district_abbreviation}/insights"
tags: ["district"]
---

# GET /district/{district_abbreviation}/insights

`GET /district/{district_abbreviation}/insights`

Gets insights for a given district.

## Path parameters

- `district_abbreviation` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- DistrictInsight
  - `district_data` object, required
    - `region_data` object, nullable, required
    - `district_wide_data` DistrictInsightRegionData, required
      - `yearly_active_team_count` object, required — Map of year to number of active teams
      - `yearly_event_count` object, required — Map of year to number of events
      - `yearly_gained_teams` object, required — Map of year to list of team keys gained
      - `yearly_lost_teams` object, required — Map of year to list of team keys lost
  - `team_data` object, nullable, required

## 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/versions/9a7cbeb48787/schema)