Eight fictional American football teams with rosters, season stats, a weekly scoreboard, live games you advance quarter by quarter, play-by-play, standings and stat leaders — built for polling, ETag and pagination practice.
Base URL: https://funapi.dev/api/football-league/v1 · 11 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.
teams and rosters
GET /football-league/v1/teams — List the 8 teams · Responds with 200 Link to this endpointGET /football-league/v1/teams/{id} — One team with its record · Responds with 200 404 Link to this endpointGET /football-league/v1/teams/{id}/roster — A team's roster with season stats · Responds with 200 404 Link to this endpointplayers and stats
GET /football-league/v1/players — Search and page through players · Responds with 200 400 Link to this endpointGET /football-league/v1/players/{id} — One player and their season stats · Responds with 200 404 Link to this endpointscoreboard and live games
GET /football-league/v1/games — Scoreboard: filter by week, team or status · Responds with 200 400 Link to this endpointGET /football-league/v1/games/{id} — One game — ETag changes when the score does; poll with If-None-Match for 304 · Responds with 200 304 404 Link to this endpointGET /football-league/v1/games/{id}/plays — Play-by-play; pass after=<last id> to read only new plays · Responds with 200 404 Link to this endpointPOST /football-league/v1/games/{id}/advance — Play the next quarter of a game (admin) — then watch the ETag change (requires Bearer auth) · Responds with 200 401 403 404 409 422 Link to this endpointstandings and leaders
GET /football-league/v1/standings — Standings computed from final games · Responds with 200 Link to this endpointGET /football-league/v1/leaders — Stat leaders · Responds with 200 400 Link to this endpointThe Pro Football League API is a fictional American football season you can test against: eight invented teams, rosters with season stats, a weekly scoreboard, standings and stat leaders. One game is live. Advance it a quarter at a time and watch its ETag change — the same polling problem a real-time scoreboard has, with none of the licensing or rate limits of real sports data.
GET https://funapi.dev/api/football-league/v1/teams — List the 8 teams. No token, no signup:
curl -i https://funapi.dev/api/football-league/v1/teams
Response: 200 OK
{
"league": "Fun Pro Football League",
"data": [
{
"id": 1,
"city": "Harbor City",
"name": "Gulls",
"fullName": "Harbor City Gulls",
"abbreviation": "HCG",
"conference": "Atlantic",
"venue": "Harbor City Stadium"
},
{
"id": 2,
"city": "Iron Valley",
"name": "Forgers",
"fullName": "Iron Valley Forgers",
"abbreviation": "IVF",
"conference": "Atlantic",
"venue": "Iron Valley Stadium"
},
{
"id": 3,
"city": "Cedar Falls",
"name": "Lumberjacks",
"fullName": "Cedar Falls Lumberjacks",
"abbreviation": "CFL",
"conference": "Atlantic",
"venue": "Cedar Falls Stadium"
},
{
"id": 4,
"city": "Bayport",
"name": "Mariners",
"fullName": "Bayport Mariners",
"abbreviation": "BPM",
"conference": "Atlantic",
"venue": "Bayport Stadium"
},
{
"id": 5,
"city": "Mesa Ridge",
"name": "Coyotes",
"fullName": "Mesa Ridge Coyotes",
"abbreviation": "MRC",
(truncated — the full response comes back when you run it)
How these leagues differ from balldontlie
Last updated