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.
https://www.thebluealliance.com/api/v3
Auth type
API Key Header
Auth header
X-TBA-Auth-Key: YOUR_API_KEY
Rate limit
Not officially published
Pricing
Enterprise / contact sales
Free quota
None
Documentation
https://www.thebluealliance.com/api/v3
Endpoint status
Server online — HTTP 404 — server is online but path returned an error (may require auth)2.59s
(checked Mar 29, 2026)
Builder score
D
43%
builder-friendly
API key in the request header (X-TBA-Auth-Key)
X-TBA-Auth-Key: YOUR_API_KEY
Free with API key. FIRST Robotics Competition data; community maintained.
| Method | Path | Description |
|---|---|---|
| GET | /district/{district_key}/events |
Gets a list of events in the given district. |
| GET | /district/{district_key}/events/keys |
Gets a list of event keys for events in the given district. |
| GET | /district/{district_key}/events/simple |
Gets a short-form list of events in the given district. |
| GET | /district/{district_key}/rankings |
Gets a list of team district rankings for the given district. |
| GET | /district/{district_key}/teams |
Gets a list of `Team` objects that competed in events in the given district. |
| GET | /district/{district_key}/teams/keys |
Gets a list of `Team` objects that competed in events in the given district. |
| GET | /district/{district_key}/teams/simple |
Gets a short-form list of `Team` objects that competed in events in the given di |
| GET | /districts/{year} |
Gets a list of districts and their corresponding district key, for the given yea |
curl -X GET 'https://www.thebluealliance.com/api/v3/district/{district_key}/events' \
-H 'X-TBA-Auth-Key: YOUR_API_KEY'
{}
Data sourced from API Map. Always verify pricing and rate limits against the official The Blue Alliance API v3 documentation.