The Blue Alliance API v3

# Overview Information and statistics about FIRST Robotics Competition teams and events. # Authentication All endpoints require an Auth Key to be passed in the header `X-TBA-Auth-Key`. If you do not have an auth key yet, you can obtain one from your [Account Page](/account).

Claim this API

Are you the operator of The Blue Alliance API v3? Submit a claim to establish contact with us.

Report an Issue

Found something wrong with The Blue Alliance API v3? Let us know about broken links, changed auth, deprecated endpoints, or other issues.

Base URL: https://www.thebluealliance.com/api/v3
Auth: unknown
Endpoints: 45
Reachable: unknown
CORS: unknown

Endpoints

Method Path Summary Auth Last Status Latency
GET /district/{district_key}/events
GET /district/{district_key}/events/simple
GET /district/{district_key}/rankings
GET /districts/{year}
GET /event/{event_key}
GET /event/{event_key}/alliances
GET /event/{event_key}/awards
GET /event/{event_key}/district_points
GET /event/{event_key}/insights
GET /event/{event_key}/matches
GET /event/{event_key}/matches/simple
GET /event/{event_key}/matches/timeseries
GET /event/{event_key}/oprs
GET /event/{event_key}/predictions
GET /event/{event_key}/rankings
GET /event/{event_key}/simple
GET /events/{year}
GET /events/{year}/simple
GET /match/{match_key}
GET /match/{match_key}/simple
GET /match/{match_key}/timeseries
GET /match/{match_key}/zebra_motionworks
GET /status
GET /team/{team_key}
GET /team/{team_key}/awards
GET /team/{team_key}/awards/{year}
GET /team/{team_key}/districts
GET /team/{team_key}/event/{event_key}/awards
GET /team/{team_key}/event/{event_key}/matches
GET /team/{team_key}/event/{event_key}/matches/simple
GET /team/{team_key}/event/{event_key}/status
GET /team/{team_key}/events
GET /team/{team_key}/events/simple
GET /team/{team_key}/events/{year}
GET /team/{team_key}/events/{year}/simple
GET /team/{team_key}/events/{year}/statuses
GET /team/{team_key}/matches/{year}
GET /team/{team_key}/matches/{year}/simple
GET /team/{team_key}/media/tag/{media_tag}
GET /team/{team_key}/media/tag/{media_tag}/{year}
GET /team/{team_key}/media/{year}
GET /team/{team_key}/robots
GET /team/{team_key}/simple
GET /team/{team_key}/social_media
GET /team/{team_key}/years_participated