---
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`

## Request

- Base URL: `https://www.thebluealliance.com/api/v3`
- URL: `https://www.thebluealliance.com/api/v3/district/{district_abbreviation}/insights`
- Auth: API key in header `X-TBA-Auth-Key`

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

## Changes

- **2025-07-02** `ccbc6f4199bd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/district/:district_abbreviation/insights/get.md)

---

[API](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3.md) - [All operations](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/revisions/9316d02dee32?raw)