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.
Endpoints
The calls behind a NFL app
Each takes league id 201295, a season id from its seasons list, or a game or team id from those. Every row opens its page in the docs.
- GET
/v2/leagues/{id}/standingsStandingsEvery table of the season with group=all.All plans - GET
/v2/fixturesFixtures by dateOne day's NFL games in a single request.All plans - GET
/v2/fixtures/{id}FixtureA game with its score by quarter, clock and down and distance.All plans - GET
/v2/fixtures/{id}/win-probability/sourceSource win probabilityThe source's home and away chances, minute by minute.Pro and up - GET
/v2/fixtures/{id}/lineupsLineupsBoth rosters with each player's figures for the game.All plans - GET
/v2/fixtures/{id}/statisticsStatisticsTeam statistics of the game, by category.All plans - GET
/v2/leagues/{id}/draftDraftA draft round in pick order, with position and college.All plans - GET
/v2/leagues/{id}/seasonsSeasonsEvery NFL season since 1920, newest first.All plans
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"{ "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.
| Topic | History | What it covers of the NFL |
|---|---|---|
| Free | Last 7 days | Live and upcoming games, the table and statistics of a season still being played, and finished games from the last 7 days. |
| Starter | Last 30 days | Live and upcoming games, the table and statistics of a season still being played, and finished games from the last 30 days. |
| Pro | Last 6 months | Live and upcoming games, the table and statistics of a season still being played, and finished games from the last 6 months. |
| Business | Last 12 months | Live and upcoming games, the table and statistics of a season still being played, and finished games from the last 12 months. |
| Enterprise | Full history | The 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
Premier League APILeague id 195828: live scores, the table, xG and every season since 1992/93.
Champions League APILeague id 4409: the 36-club league phase, the knockout bracket and every season since 1992/93.
La Liga APILeague id 4408: Spain's top flight, head-to-head records and every season since 1969/70.
Serie A APILeague id 195910: Italy's top flight, venues and the longest big-five archive, back to 1965/66.
Bundesliga APILeague id 195937: Germany's 18 clubs, the team of the week and every season since 1970/71.
Ligue 1 APILeague id 195793: France's top flight, every player's statistics and seasons since 1970/71.
World Cup APILeague id 195843: all 23 tournaments from 1930 to 2026, group tables and the bracket.
NBA APILeague id 198277: box scores, play-by-play, shot charts, the draft and live player tracking.
NHL APILeague id 201302: conference and division tables, shot maps by strength, the three stars and playoff series.
MLB APILeague id 201220: the live count, every at-bat and pitch, umpire crews and ballpark weather.
IPL APILeague id 195830: full scorecards, every ball with wagon wheel and pitch map, and seasons since 2013.
Süper Lig APILeague id 172801: Turkey's top division, its referees on record and seasons back to 1980/81.
MLS APILeague id 6540: 30 clubs, two conference tables and calendar-year seasons since 2008.
Europa League APILeague id 43443: one 36-club table, knockout ties on aggregate and seasons since 2009/10.
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.