Stable fields only.Examples are trimmed. Responses include other fields, such as legacy metrics, that are not supported and may change or disappear. Routes that refresh or sync data are not public and are not listed.
Seasons and summary
Season catalog, a snapshot of the current state of the data, and metric distributions.
GET/api/seasons
The season catalog and the current default season. Each season says whether its score schema and advancement rules are verified; OPR and score breakdowns are unavailable until the score schema is.
Season snapshot: matches played, the highest-scoring match, top teams by Elo, the number of Worlds-qualified teams, and recent activity. Cached for five minutes. The availability objects say which parts could be computed.
Parameters for GET /api/summary
Parameter
Type
Description
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
Quantiles and histogram bins for one metric across a season, optionally with one team’s value and percentile. OPR, consistency, and the legacy momentum metric return 400 for seasons whose score schema is not verified.
Parameters for GET /api/stats/distribution
Parameter
Type
Description
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
metricstring
string
overall_elo, matches_played, consistency_index, or opr. The legacy momentum metric is also accepted. Default: overall_elo.
eventstring
string
Event code. Required when metric is opr, because OPR is specific to an event.
teaminteger
integer
Team number to include as selected_team, with its value and percentile.
Season rankings with server-side filtering, sorting, and paging.
GET/api/leaderboard
One page of team ratings for a season. Rows include identity, Elo, OPR where available, record, and Worlds status. Pass fields=compact to load a whole season in one request.
Parameters for GET /api/leaderboard
Parameter
Type
Description
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
limitinteger
integer
Rows per page, from 1 to 20000. Default: 100.
offsetinteger
integer
Rows to skip, for paging. has_more in the response says whether another page exists. Default: 0.
order_bystring
string
Sort column: overall_elo, opr, best_event_opr, consistency_index, matches_played, wins, losses, ties, region, or last_updated. Score-derived columns fall back to overall_elo for seasons without a verified score schema. Default: overall_elo.
order_dirstring
string
asc or desc. ascending=true is also accepted. Default: desc.
min_matchesinteger
integer
Only teams with at least this many matches. Default: 0.
regionstring
string
Region filter: a state or region code or name, such as FL, USFL, or Florida.
countrystring
string
Country name, such as USA or Canada.
searchstring
string
A team number matches exactly. Other text matches team name, region, state, or country.
rookie_yearinteger
integer
Only teams whose rookie year matches.
eventstring
string
Only teams that played at this event code.
worlds_qualified_onlyboolean
boolean
true to return only teams qualified for the FIRST Championship.
rank_periodstring
string
Adds elo_rank and rank_change to each row: previous_event, previous, 7d, 30d, or season. rank_movement in the response says whether a comparison exists.
fieldsstring
string
compact returns a reduced row (see the note below). Any other value returns full rows.
fields=compact keeps team_number, season, region, overall_elo, opr, best_event_opr, highest_np_score, wins, losses, ties, matches_played, consistency_index, strength_of_schedule, the RP rate, probability, and count fields, worlds_advancement_rank, last_event_code, last_event_rank, and last_calculated. teams is reduced to name, region, state, and country, and per_event_metrics to { elo, opr, elo_delta } per event. The response also carries "fields": "compact".
Teams
Search, profiles, and per-team history. Team routes take team_number in the path.
GET/api/teams/search
Find teams by number, name, or location. Results are ranked: exact team number, team numbers starting with the digits typed, name (exact, prefix, then substring), then location. Location understands full state, province, and country names (massachusetts, ontario, canada) as well as codes. Lower team numbers come first within a tier.
Parameters for GET /api/teams/search
Parameter
Type
Description
qrequiredstring
string
Search text, up to 80 characters. An empty query returns an empty list.
A team’s profile and season metrics: Elo, OPR, record, global and regional rank with percentiles, and per-event ratings. Returns 404 for an unknown team and metrics: null when the team has no rated matches that season.
Parameters for GET /api/team/{team_number}
Parameter
Type
Description
team_numberpathinteger
integer
FTC team number.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
Events the team played, in date order, each with its record, scoring averages, and every match. team_names maps team numbers seen in those matches to names.
Parameters for GET /api/team/{team_number}/events
Parameter
Type
Description
team_numberpathinteger
integer
FTC team number.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
The team’s match history grouped by event, from the team’s point of view: alliance scores, result (W, L, or T), ranking points earned, penalties, and the raw score breakdown.
Parameters for GET /api/team/{team_number}/matches
Parameter
Type
Description
team_numberpathinteger
integer
FTC team number.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
One row per match with the team’s scoring components and its Elo and OPR at that point. Scoring field names follow the season’s game. For a season whose score schema is not verified, data is empty, score_metrics_available is false, and score_metrics_message says why.
Parameters for GET /api/team/{team_number}/stats_over_time
Parameter
Type
Description
team_numberpathinteger
integer
FTC team number.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
One row per event, in order, with the team’s Elo and OPR at that event. cumulative_elo can repeat the season-end rating in stored data, so use elo to chart progression.
Parameters for GET /api/team/{team_number}/event_metrics_over_time
Parameter
Type
Description
team_numberpathinteger
integer
FTC team number.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
Awards the team won in a season. Loaded separately from the profile so a slow awards lookup does not block it. availability says whether the awards source answered.
Parameters for GET /api/team/{team_number}/awards
Parameter
Type
Description
team_numberpathinteger
integer
FTC team number.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
Every match at the event, with alliances, scores, and the score breakdown. Played matches come from storage and scheduled matches from FIRST. Win probabilities and upset flags are included when computed.
Parameters for GET /api/events/{event_code}/matches
Parameter
Type
Description
event_codepathstring
string
Event code, such as USMACMP.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
sort_bystring
string
match_num or np_score (combined non-penalty score, highest first). Default: match_num.
Official event rankings from FIRST joined with this site’s ratings: season Elo, event Elo, and OPR. Returns an empty list with a message when FIRST has not published rankings.
Parameters for GET /api/events/{event_code}/rankings
Parameter
Type
Description
event_codepathstring
string
Event code, such as USMACMP.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
sort_bystring
string
official (default; also rs), tbp, np_avg, np_max, opr, event_opr, event_elo, or overall_elo. Anything else sorts by official rank. Default: official.
Awards at the event, each with the advancement points it is worth, grouped into robot performance, judged, and other. The list is empty until FIRST publishes awards.
Parameters for GET /api/events/{event_code}/awards
Parameter
Type
Description
event_codepathstring
string
Event code, such as USMACMP.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
Advancement point breakdown for each team at the event: qualification, alliance selection, playoffs, and awards, with tiebreak statistics. advancement_slots is a rough estimate (a quarter of the field), not the official allocation. Seasons without verified advancement rules return available: false. Can return 500 or 404 when rankings are missing from FIRST.
Parameters for GET /api/events/{event_code}/advancement
Parameter
Type
Description
event_codepathstring
string
Event code, such as USMACMP.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
A single match, and win probability for any alliance pairing.
GET/api/match/{season}/{event_code}/{match_id}
One match in full: alliances, scores, winner, ranking points, penalties, and the score breakdown. Add team_number to get the same match from that team’s point of view. Returns 404 if the match is not found.
Parameters for GET /api/match/{season}/{event_code}/{match_id}
Parameter
Type
Description
seasonpathinteger
integer
Season start year.
event_codepathstring
string
Event code, such as USMACMP.
match_idpathinteger
integer
Match ID within the event, as returned by the matches routes.
team_numberinteger
integer
Team whose point of view to use; adds team_alliance, result, and opponent_score.
Estimated win probability for a 2v2 match from season Elo. This is an estimate: score forecasts are unavailable and the model has not been validated against historical results. Teams without a rating start at 1500, and rating_coverage says how many of the four had one. Returns 400 for invalid or duplicate team numbers.
Parameters for POST /api/predict
Parameter
Type
Description
red1_teamrequiredbodyinteger
integer
Red alliance team, 1 to 99999.
red2_teamrequiredbodyinteger
integer
Red alliance team, different from the others.
blue1_teamrequiredbodyinteger
integer
Blue alliance team, different from the others.
blue2_teamrequiredbodyinteger
integer
Blue alliance team, different from the others.
seasonbodyinteger
integer
Season whose ratings to use. Default: current season.
The prediction object also includes a details object for each of the four teams (red1_details through blue2_details) with their season metrics.
Worlds advancement
Regional championship allocations and teams qualified for the FIRST Championship. For a season whose allocations are not verified, these return available: false with status 200 and no data.
GET/api/advancement/regions
Every regional championship with its slot allocation, date, and status. A region counts as complete once its championship date has passed, and filled_slots then equals worlds_reserved; it does not mean team names have been published.
Parameters for GET /api/advancement/regions
Parameter
Type
Description
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
statusstring
string
complete, pending, pending_finalization, or all. Default: all.
countrystring
string
Only regions in this country, such as USA or Canada.
One region: its allocation, the championship events matched to it, and advancement points for each team when FIRST has marked an event finished. Looks up FIRST data live, so it is slower than the list and teams may be empty. Returns 404 for an unknown region.
Parameters for GET /api/advancement/regions/{region_id}
Parameter
Type
Description
region_idpathstring
string
Region ID from the regions list, such as michigan.
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.
Teams qualified for the FIRST Championship, highest advancement points first. This is the list stored in the database, which can lag behind regions marked complete.
Parameters for GET /api/advancement/teams
Parameter
Type
Description
seasoninteger
integer
Season start year, such as 2025 for 2025–26. Default: current season.