---
title: "GET /event/{event_key}/insights"
method: GET
path: "/event/{event_key}/insights"
tags: ["event"]
---

# GET /event/{event_key}/insights

`GET /event/{event_key}/insights`

## Request

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

Gets a set of Event-specific insights for the given Event.

## Path parameters

- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- EventInsights: A year-specific event insight object expressed as a JSON string, separated in to `qual` and `playoff` fields. See also Event_Insights_2016, Event_Insights_2017, etc.
  - `qual` object: Inights for the qualification round of an event
  - `playoff` object: Insights for the playoff round of an event

## Other responses

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

## Changes

- **2026-04-03** `e02edcb016b7`: 2 breaking, 2 warning
  - added `#/components/schemas/Event_Insights, subschema #2` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `null, object` to no type for status `200`
  - removed the optional property `playoff` from the response with the `200` status
  - removed the optional property `qual` from the response with the `200` status
- **2025-07-02** `ccbc6f4199bd`: 2 breaking, 3 info
  - the response's body became nullable
  - the response's body type changed from no type to `null, object` for status `200`
  - removed `#/components/schemas/Event_Insights` from the response body `allOf` list for the response status `200`
  - added the optional property `playoff` to the response with the `200` status
  - …1 more
- **2024-09-21** `30390dd088e5`: 2 breaking, 2 warning, 2 info
  - the response's body became nullable
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `playoff` from the response with the `200` status
  - removed the optional property `qual` from the response with the `200` status
  - …2 more
- **2024-03-29** `7bf03129c828`: 1 info
  - added the media type `application/json` for the response with the status `401`
- …earlier changes not shown

[Operation history](https://skmtc.dev/thebluealliance/apis/the-blue-alliance-api-v3/changes/event/:event_key/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)