Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

American football · USA · 32 teams

NFL API with down and distance and live win probability

An NFL API for live scores by quarter, down and distance, standings, line-ups, statistics and the draft on league id 201295, with seasons back to 1920. From Pro, each game also carries the source's own win probability for every minute of play.

  • Seasons since 1920
  • 32 teams · 272 regular-season games
  • League id 201295
  • Down and distance, live

NFL

GET /v2/leagues/201295

League id
201295
Category
USA
Tier
1
Archive
Seasons since 1920
Teams
32 teams
Matches
272 regular-season games
Live channel
league:201295

In the data

The NFL in the API

What league id 201295 holds, and how its seasons are laid out.

The state of the game

A live NFL fixture carries downAndDistance: the down, the yards to go, which side has the ball, where it sits and whether it is goal to go, next to the score by quarter and the clock. Score, status and clock are current to the second over REST, and from Business the WebSocket channel league:201295 pushes each change of every game in play.

Win probability from the source

/v2/fixtures/{id}/win-probability/source (Pro) returns the home and away chances for each minute of play, as the source publishes them. The NFL is the only sport it publishes them for; we pass the figures on unchanged and mark them source, apart from our own model, which covers football (soccer).

Season, playoffs and the draft

A regular season is 272 games: 32 teams, 17 games each. The standings hold several tables, which group=all returns together. The preseason is a competition of its own (201297), so its results never mix into the regular season, and /draft?year= returns the draft round by round, each pick with the prospect's position and college.

First request

The NFL in three calls

Every call starts from the league id, 201295. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.

The answers use the usual { data, meta } envelope and the same field names as every other american football competition, so the code works unchanged for the next league you add.

# Every season, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/201295/seasons" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# Every table of the season
curl "https://api.datasportsapi.com/v2/leagues/201295/standings?season={seasonId}&group=all" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# The first round of the 2026 draft
curl "https://api.datasportsapi.com/v2/leagues/201295/draft?year=2026" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
GET /v2/leagues/201295 · trimmed
{ "data": {
    "id": 201295, "name": "NFL", "sport": "american-football",
    "category": "USA", "country": { "code": "US", "name": "USA" },
    "tier": 1, "gender": "male",
    …
} }

History

How much of the NFL each plan reads

The archive goes back to 1920. Each plan reads back a set time from today; nothing live or upcoming is ever held back.

TopicHistoryWhat it covers of the NFL
FreeLast 7 daysLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 7 days.
StarterLast 30 daysLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 30 days.
ProLast 6 monthsLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 6 months.
BusinessLast 12 monthsLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 12 months.
EnterpriseFull historyThe whole archive: seasons since 1920.

Questions

NFL API, answered

Anything else? The full FAQ covers quota, plans and the data in general.

Does the NFL API give down and distance?

Yes, on every plan. While a game is in progress, the fixture's downAndDistance holds the down, yards to go, the side in possession, the side of the field the ball is on, the yard line and a goal-to-go flag. It is null before kick-off, after the final whistle and during interruptions.

Is the NFL win probability your own model?

No. /v2/fixtures/{id}/win-probability/source passes on the figures the source publishes, minute by minute, and labels them source; we do not know how they are calculated. Our own win-probability model covers football (soccer) only. Treat either as an analytical indicator, not betting advice.

Does it include the NFL draft?

Yes, on every plan. /v2/leagues/201295/draft?year=2026&round=1 lists the picks in order with the selecting team, the team a traded pick came from, and the prospect's position and college as the draft records them; pass round up to 7 for the later rounds.

How far back does NFL data go?

To the 1920 season. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming games, and the table and statistics of a season still being played, are open on every plan.

Can I follow NFL games live on the free plan?

Yes. Live and upcoming games are never held back by a plan, so a Free key follows every NFL game in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:201295 pushes every change instead.

Keep reading

Other competitions

Everything in the american football data Sports statistics API Live scores API

Build on the NFL today.

1,000 free requests a day during the beta. No card, no sales call.