NFL API: Get standings
Gets NFL regular-season standings by conference and division for a season, with clinch status when shown.
Unofficial. Not affiliated with or endorsed by NFL.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Season optional
season Season starting year, such as 2025. Defaults to the current season.
2025
Whole number.
Input as JSON
{ "season": 2025}Output
{ "teams": [ { "team": "New England Patriots", "ties": 0, "wins": 14, "losses": 3, "division": "AFC East", "page_link": "https://www.nfl.com/teams/new-england-patriots/" , "conference": "AFC", "division_rank": 1, "points_scored": 490, "current_streak": "Won 3", "points_allowed": 320, "win_percentage": 0.824, "playoff_or_clinch_status": "Clinched Playoff; Clinched Division" }, { "team": "Buffalo Bills", "ties": 0, "wins": 12, "losses": 5, "division": "AFC East", "page_link": "https://www.nfl.com/teams/buffalo-bills/" , "conference": "AFC", "division_rank": 2, "points_scored": 481, "current_streak": "Won 1", "points_allowed": 365, "win_percentage": 0.706, "playoff_or_clinch_status": "Clinched Playoff; Clinched Wild Card" }, { "team": "Miami Dolphins", "ties": 0, "wins": 7, "losses": 10, "division": "AFC East", "page_link": "https://www.nfl.com/teams/miami-dolphins/" , "conference": "AFC", "division_rank": 3, "points_scored": 347, "current_streak": "Lost 1", "points_allowed": 424, "win_percentage": 0.412, "playoff_or_clinch_status": null } ], "season": 2025}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nfl.com/get_standings","input":{"season":2025}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "nfl.com/get_standings" , "input": { "season": 2025 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "nfl.com/get_standings" , "input": { "season": 2025 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run nfl.com/get_standings# with {"season":2025}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "season": { "type": "integer", "description": "Season starting year, such as 2025. Defaults to the current season." } }}Output schema
{ "type": "object", "required": [ "season", "teams" ], "properties": { "teams": { "type": "array", "items": { "type": "object", "properties": { "team": { "type": "string" }, "ties": { "type": "integer" }, "wins": { "type": "integer" }, "losses": { "type": "integer" }, "division": { "type": "string" }, "page_link": { "type": "string" }, "conference": { "type": "string" }, "division_rank": { "type": "integer" }, "points_scored": { "type": "integer" }, "current_streak": { "type": [ "string", "null" ] }, "points_allowed": { "type": "integer" }, "win_percentage": { "type": "number" }, "playoff_or_clinch_status": { "type": [ "string", "null" ] } } } }, "season": { "type": "integer" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
nfl.com/get_standings- Returns
- season, teams with division, rank, record, points, streak, clinch status
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method nfl.com/get_standings with the inputs above.
Ask your agent
- Show me the 2024 NFL standings broken down by conference and division, including each team's clinch status.
- What were the final regular-season records and win streaks for every AFC team in 2022?
- Can you pull up the current NFL division standings with points scored and which playoff spots are already clinched?
- I need the 2019 season standings for the NFC North with each team's rank, record, and streak.
- Which NFL teams have clinched playoff berths so far this season, and where do the division races stand on nfl.com?
See more
All NFL methodsGets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
nfl.com/get_scoresGets a named NFL player's season and career stats, with profile details. Active players are preferred when names match.
nfl.com/get_player_statsGets an NFL team's current NFL.com roster by team name, nickname or city. You can limit it to offense, defense or special teams. Released players are left out.
nfl.com/get_team_rosterReturns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page.
nba.com/get_standingsReturns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year.
mlb.com/get_standingsReturns Yahoo Sports team standings for a league and season, grouped by division or conference.
sports.yahoo.com/get_standingsGets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage.
nhl.com/get_standingsGets Formula 1 drivers' and teams' championship standings for a season, with the last completed race. Teams' standings begin in 1958.
formula1.com/get_standings