NCAA Division I FBS Football
College football API. Every FBS game, play by play, in the same JSON as the NFL.
Scores, play-by-play, drives, box scores and game rosters for NCAA Division I FBS football. The endpoints and JSON match the NFL, so one parser reads both leagues.
- Alias
- ncaaf
- Status
- Live
- REST
- from $19 a month
- WebSocket
- from $49 a month
Sample game
Arkansas 23 at Auburn 26. November 7, 2026.
These are untrimmed responses from the real API for one NCAAF game, free to download without a key. The game was replayed through Statpad's ingest into a fresh database, so the ids and every updated_at are from that run.
A finished game: 197 plays in 25 drives, decided by a field goal with 33 seconds left after Arkansas tied it at 23 with under two minutes to go.
The files are the exact bodies the API returned after the final whistle, untrimmed.
Its play-by-play has 197 plays:
rush75pass70kickoff12timeout10punt9field_goal7penalty7other6
{
"away_score": 23,
"basketball": null,
"clock_seconds": 33,
"description": "(00:33) #38 A.McPherson field goal attempt from 43 yards GOOD (H: #14 H.Kaak, LS: #59 H.Powell), clock 00:33",
"football": {
"air_yards": null,
"down": 4,
"end_yardline": null,
"is_first_down": false,
"is_penalty": false,
"is_touchdown": false,
"is_turnover": false,
"penalty_yards": null,
"play_action": null,
"play_type": "field_goal",
"run_pass_option": null,
"screen_pass": null,
"start_yardline": 75,
"yards_gained": 43,
"yards_to_go": 3
},
"game_id": "01a1e731-de65-7f3d-ad77-6d83c8faac2c",
"group_id": "01a1e731-de65-7f9e-a8ae-1132a5c02346",
"hockey": null,
"home_score": 26,
"id": "01a1e731-de66-705e-8a94-18882d706577",
"is_official": true,
"is_scoring": true,
"participants": [
{
"player_id": "01a1e731-de65-7f85-b934-035c6e592915",
"role": "kicker",
"team_id": "01a1e731-de65-7f3e-a395-3ad85e3d0a11"
},
{
"player_id": "01a1e731-de65-7f85-b934-035c6e592915",
"role": "scorer",
"team_id": "01a1e731-de65-7f3e-a395-3ad85e3d0a11"
}
],
"period": 4,
"period_half": null,
"points": 3,
"sequence": 184000,
"soccer": null,
"team_id": "01a1e731-de65-7f3e-a395-3ad85e3d0a11",
"type": "field_goal",
"updated_at": "2026-11-17T01:49:27.523774Z",
"version": 1,
"wall_clock": "2026-11-07T21:18:05Z"
}The last scoring play: Alex McPherson's 43-yard field goal with 33 seconds left. Football plays carry down, distance, yard lines and yards gained under football, and participants names the kicker.
{
"game_id": "01a1e731-de65-7f3d-ad77-6d83c8faac2c",
"player_id": "01a1e731-de65-7f41-b096-42b15873516a",
"stats": {
"passing": {
"att": 30,
"qbr": 45.2,
"yards": 180,
"touchdowns": 1,
"completions": 14,
"interceptions": 1,
"yards_per_attempt": 6
},
"rushing": {
"att": 9,
"yards": -27,
"longest": 13,
"touchdowns": 0,
"yards_per_attempt": -3
}
},
"team_id": "01a1e731-de65-7f3f-8605-11553c60a7c9",
"version": 2
}KJ Jackson's line in the box score, in the same categories as the NFL. College defense lines have qb_hurries where the NFL has qb_hits.
Every file from this game
A whole NFL game you can replay change by change is on Sample responses.
Endpoints
REST at https://api.statpad.dev and one WebSocket at wss://stream.statpad.dev/v1/stream. Every league uses the same paths and JSON, so changing ncaaf to another alias keeps your parser working.
| Request or stream | What it returns |
|---|---|
| GET /v1/ncaaf/games?date=2026-11-07 | A day's games with status, start time and score. Pass from and to instead for a range of up to 31 days. |
| GET /v1/ncaaf/games/{id} | One game with its teams, venue and live state |
| GET /v1/ncaaf/games/{id}/plays | Every play, in game order |
| GET /v1/ncaaf/games/{id}/play-groups | Every drive, with yards, time of possession and result |
| GET /v1/ncaaf/games/{id}/boxscore | A stat line for each player |
| GET /v1/ncaaf/games/{id}/roster | The players in the game, with team and jersey |
| GET /v1/ncaaf/games/{id}/changes?after_seq=0 | Every change after a seq: the same journal the stream sends |
| GET /v1/ncaaf/teams | The league's teams |
| game:<id> | WebSocket stream for one game: the game, its live state, plays, stats and roster, in seq order |
| league:ncaaf | WebSocket stream for what the league's games share: teams, players and venues, plus injuries |
A client that reconnects to the stream with the last seq it saw gets exactly the changes it missed. The API reference has every parameter and schema.
What every college football game has
From Coverage by league. Everything but injuries comes from the live game feed and updates during the game.
| Data | Where | NCAAF |
|---|---|---|
| Schedule | GET /v1/{league}/games | Every game the league has published with both teams known, through the end of its season, with status, start time and score |
| Live state | live_state on GET /games/{id} | Period, clock, score, possession, down, distance, yard line and timeouts. After the final, the last down, distance and yard line stay, and timeouts are null because the feed stops reporting them. |
| Game timing | started_at, ended_at on the game; last_play_id on the live state | When the first play happened and, once the game is over, the last one, from the play-by-play's own clock; the newest play of any type, timeouts and period ends included |
| Play-by-play | GET /games/{id}/plays | Every play: type, description, down and distance, start and end yard line, yards gained, penalty yards, first down, touchdown, turnover, score after the play, and the players involved with their roles. NFL passes that are completed also have air_yards: how far past the line of scrimmage the receiver caught the ball, negative behind it. It's null on incompletions, on every other play and in NCAAF, whose feed has no yards after the catch. A player the game's box score doesn't list, such as a long snapper, is left out of participants. On a live game a play can arrive with an empty or partial list and fill in on a later version. |
| Drives | GET /games/{id}/play-groups | Every drive: plays, yards, first downs, start and end yard line, time of possession, result and points |
| Player box score | players in GET /games/{id}/boxscore | Passing, rushing, receiving, defense, interceptions, fumbles, kicking, punting, kick returns and punt returns |
| Game roster | GET /games/{id}/roster | The players with a box-score line, with team and jersey |
| Injuries | GET /v1/ncaaf/injuries | Not filled yet |
| Teams, players and venues | /teams, /players/{id} | Every team and player that has appeared in a game |
| Change journal | GET /games/{id}/changes and the stream | Yes |
- Statpad started collecting in November 2026 and doesn't backfill earlier seasons, so it is a source for the game in progress, not for college football history.
- A Saturday can have many games at once. Pro streams 20 subscriptions at a time and Business 150, and every game is on REST on every plan.
- The NCAAF injury report isn't filled yet.
Box score stat codes in this game
| Category | Codes |
|---|---|
| passing | att, qbr, yards, touchdowns, completions, interceptions, yards_per_attempt |
| rushing | att, yards, longest, touchdowns, yards_per_attempt |
| fumbles | lost, fumbles, recovered |
| punt_returns | yards, longest, returns, touchdowns, yards_per_return |
| receiving | yards, longest, receptions, touchdowns, yards_per_reception |
| defensive | sacks, tackles, qb_hurries, touchdowns, solo_tackles, passes_defended, tackles_for_loss |
| kick_returns | yards, longest, returns, touchdowns, yards_per_return |
| kicking | points, field_goal_pct, field_goals_made, extra_points_made, longest_field_goal, field_goal_attempts, extra_point_attempts |
| punting | punts, yards, longest, inside_20, touchbacks, gross_average |
| interceptions | yards, touchdowns, interceptions |
A player only has the categories and codes that apply to them, so treat every code as optional.
Not filled yet
These endpoints and fields are part of the API, but nothing fills them for NCAAF today. Code written against them keeps working when the data arrives.
| Data | Where | What you get today |
|---|---|---|
| Team totals | teams in the box score | An empty list. Add up the player lines for team totals. |
| Score by period | period_scores on the game and the box score | An empty list. Plays carry the score after each play. |
| Team rosters | GET /teams/{id}/roster | An empty list. A game's roster lists the players in that game. |
| Depth charts | GET /teams/{id}/depth-chart | 404 |
| Injuries | GET /{league}/injuries | An empty list |
| Injury practice status and notes | practice_status and comment on an injury | null |
| Transactions | GET /{league}/transactions?since= | An empty list |
| Season stats and leaders | GET /players/{id}/stats, GET /seasons/{year}/{type}/leaders | Empty lists |
| Football play tags | play_action, screen_pass, run_pass_option | Deprecated and always null: no provider reports them. They stay in the response so existing parsers keep working. |
| Running clock | clock_running on the live state | null: the football feed has no running flag, and its clock moves only when a play posts. Use status and clock_seconds. |
| Player details | birth_date, height_in, weight_lb, college and draft on players | null |
| Football player positions | primary_position on players (NFL players who have been on the injury report have it), and position and starter on a game roster entry | null, and starter is always false |
History, and staying right
Statpad started collecting each league in November 2026 and doesn't backfill earlier games or seasons. Once collected, a game's plays, box score and roster stay readable over REST for good, and its change journal for at least 7 days after it ends.
A play or stat line can change after it first appears, during the game and shortly after it. The newer version arrives as an upsert with a higher version, on the same stream and in the same seq order as everything else. Key what you store by id and keep the highest version, and your app shows the current data with no special handling.
Pricing
Every plan includes all 10 leagues and every REST endpoint. Plans differ in volume, streaming and keys, and the limits are hard caps with no overage.
Compare every limitDeveloper
$19 a month
- 25,000 requests a month
- 1 request a second, burst of 10
- REST only, no WebSocket
Pro
$49 a month
- 150,000 requests a month
- 10 requests a second, burst of 30
- WebSocket: 5 connections, 20 subscriptions
Business
$299 a month
- 2,000,000 requests a month
- 25 requests a second, burst of 100
- WebSocket: 10 connections, 150 subscriptions