---
title: "GET /match/{match_key}/zebra_motionworks"
method: GET
path: "/match/{match_key}/zebra_motionworks"
tags: ["match"]
---

# GET /match/{match_key}/zebra_motionworks

`GET /match/{match_key}/zebra_motionworks`

## Request

- Base URL: `https://www.thebluealliance.com/api/v3`
- URL: `https://www.thebluealliance.com/api/v3/match/{match_key}/zebra_motionworks`
- Auth: API key in header `X-TBA-Auth-Key`

Gets Zebra MotionWorks data for a Match for the given match key.

## Path parameters

- `match_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- Zebra
  - `key` string, required: TBA match key with the format `yyyy[EVENT_CODE]_[COMP_LEVEL]m[MATCH_NUMBER]`, where `yyyy` is the year, and `EVENT_CODE` is the event code of the event, `COMP_LEVEL` is (qm, ef, qf, sf, f), and `MATCH_NUMBER` is the match number in the competition level. A set number may be appended to the competition level if more than one match in required per set.
  - `times` number[], required: A list of relative timestamps for each data point. Each timestamp will correspond to the X and Y value at the same index in a team xs and ys arrays. `times`, all teams `xs` and all teams `ys` are guarenteed to be the same length.
  - `alliances` object, required
    - `red` ZebraTeam[]: Zebra MotionWorks data for teams on the red alliance
      - `team_key` string, required: The TBA team key for the Zebra MotionWorks data.
      - `xs` number[], required: A list containing doubles and nulls representing a teams X position in feet at the corresponding timestamp. A null value represents no tracking data for a given timestamp.
      - `ys` number[], required: A list containing doubles and nulls representing a teams Y position in feet at the corresponding timestamp. A null value represents no tracking data for a given timestamp.
    - `blue` ZebraTeam[]: Zebra data for teams on the blue alliance
      - `team_key` string, required: The TBA team key for the Zebra MotionWorks data.
      - `xs` number[], required: A list containing doubles and nulls representing a teams X position in feet at the corresponding timestamp. A null value represents no tracking data for a given timestamp.
      - `ys` number[], required: A list containing doubles and nulls representing a teams Y position in feet at the corresponding timestamp. A null value represents no tracking data for a given timestamp.

## 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
  - endpoint added

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