Pro Football League API

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

teams and rosters

players

players and stats

games

scoreboard and live games

season

standings and leaders

The 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.

What you can practise here

Example request and response

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)

Open and run this endpoint

All 55 mock REST APIs

Use this response elsewhere

How these leagues differ from balldontlie

Last updated