---
title: "GET /event/{event_key}/matches/timeseries"
method: GET
path: "/event/{event_key}/matches/timeseries"
tags: ["event", "match"]
---

# GET /event/{event_key}/matches/timeseries

`GET /event/{event_key}/matches/timeseries`

## Request

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

Gets an array of Match Keys for the given event key that have timeseries data. Returns an empty array if no matches have timeseries data.
*WARNING:* This is *not* official data, and is subject to a significant possibility of error, or missing data. Do not rely on this data for any purpose. In fact, pretend we made it up.
*WARNING:* This endpoint and corresponding data models are under *active development* and may change at any time, including in breaking ways.

## Path parameters

- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- string[]

## Other responses

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

## Changes

- **2024-09-21** `30390dd088e5`: 1 info
  - added the non-success response with the status `404`
- **2024-03-29** `7bf03129c828`: 1 info
  - added the media type `application/json` for the response with the status `401`
- **2022-11-18** `5b245377faaf`: 2 warning, 1 info
  - the optional response header `Last-Modified` removed for the status `200`
  - deleted the `header` request parameter `If-Modified-Since`
  - added the new optional `header` request parameter `If-None-Match`
- **2020-03-06** `a78c0ff8885f`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2018-04-20** `17c96186dc7c`: 1 info
  - endpoint added

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