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

# GET /event/{event_key}/nexus_info

`GET /event/{event_key}/nexus_info`

## Request

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

Gets live match-queuing info and the pit map for an event from Nexus (https://frc.nexus/), or `null` if neither is currently available for this event.

## Path parameters

- `event_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- NexusEventInfo: Live match-queuing info and the pit map for an event, sourced from Nexus (https://frc.nexus/) and cached by TBA.
  - `data_as_of_ms` integer, nullable, required: Unix timestamp (in milliseconds) of when the queuing info was last fetched from Nexus, or null if no queuing info is available.
  - `now_queueing` NexusNowQueueing, required: The match currently being queued, as reported by Nexus.
    - `match_key` string, required: TBA match key for the match currently being queued.
    - `match_name` string, required: The match name as reported by Nexus, e.g. `Qualification 5`.
  - `matches` object, required: Map of TBA match key to live queuing info for that match. Empty if no queuing info is available.
  - `pit_map` NexusPitMap, required: The pit map for an event, as reported by Nexus. Each collection maps a Nexus element ID to that element.
    - `size` NexusMapVector, required: A pair of x and y values on a Nexus pit map, used for positions and sizes.
      - `x` number
      - `y` number
    - `pits` object, required
    - `areas` object, required
    - `labels` object, required
    - `arrows` object, required
    - `walls` object, required

## Other responses

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

## Changes

- **2026-11-12** `9316d02dee32`: 1 breaking, 1 info
  - response property `oneOf[#/components/schemas/Nexus_Event_Info]/data_as_of_ms` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the required property `oneOf[#/components/schemas/Nexus_Event_Info]/pit_map` to the response with the `200` status
- **2026-07-26** `9a7cbeb48787`: 1 info
  - endpoint added

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