API-NFL

Follow American football with API-NFL: NFL and college (NCAA) games and results with the score by quarter, scoring plays, team and player box scores, players' season statistics, injuries, standings, head-to-head records and bookmakers' pre-match odds. Needs an API-SPORTS key; the free plan allows 100 requests a day.

Actions

Action	What it does
Find players	Find players by name or ID, or list a team's players in a season, each with their age, height, weight, college, position, shirt number and years in the league.
Find teams	Find NFL and college teams by name, code, ID, or league and season, each with its logo and, for an NFL club, its code, city, owner, stadium and founding year.
Get a game	Get one game by ID: its stage and week, venue, status, and both sides' points by quarter and in overtime.
Get account status	See the connected key's API-NFL plan, when it renews, and how many of today's requests are used and left.
Get player box scores	Get every player's box score for a game, or one group's, team's or player's: passing, rushing, receiving, fumbles, interceptions, defense, kick and punt returns, kicking and punting, each figure a number.
Get player season statistics	Get a player's season statistics, or those of every player on a team: passing, rushing, receiving, scoring, defense, returns, punting and kicking, each figure a number.
Get pre-match odds	Get bookmakers' pre-match odds for a game, optionally from one bookmaker or for one bet type.
Get scoring plays	Get a game's scoring plays in order: the quarter and clock, the side and player, the kind of score, the play as written (such as Patrick Mahomes 15 Yd Rush) and the score after it.
Get standings	Get a season's standings, one table per division: each team's place, wins, losses and ties, win percentage, points for and against, home, road, conference and division records, and streak.
Get team box scores	Get both teams' box scores for a game, or one team's: first downs, third and fourth downs, plays and yards, passing and rushing, red zone trips, penalties, turnovers, time of possession, and its defense's interceptions, sacks and points allowed.
List bet types	List the kinds of bet API-NFL has odds for, such as Home/Away, Asian Handicap or Over/Under, with the IDs the odds filter takes.
List bookmakers	List the bookmakers API-NFL has odds from, with the IDs the odds filter takes.
List conferences	List a season's conferences, such as the NFL's American and National Football Conferences, by the names Get standings takes.
List divisions	List a season's divisions, such as AFC East, by the names Get standings takes.
List games	List games and results by day, by league or team and season, or every game in play, each with its stage and week, venue, status, and both sides' points by quarter and in overtime.
List head-to-head games	List the games two teams have played each other, in every season or one, games to come included, with a count of each side's wins and points across the finished ones.
List injuries	List the players injured now on a team, or one player's injury: the injury, their status (such as Questionable or Out) and when it was reported.
List leagues	List the two leagues API-NFL covers, the NFL and the NCAA (college football), each with every season on file, its dates, and what the API has for it: scoring plays, box scores, season statistics, injuries and standings.
List seasons	List the seasons API-NFL has data for, oldest first, as the years the Season fields take.

Find players

Find players by name or ID, or list a team's players in a season, each with their age, height, weight, college, position, shirt number and years in the league.

Inputs

Player IDplayer_idtext: Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.
Teamteam_idtext: Optional. Only this team's players; needs a season too. Pick an NFL club from the list, or pass a team ID.
Seasonseasonnumber: Optional. Only this season, as the year it starts in, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

countnumber: How many came back.
playerslist: The players.

Example output

{
  "count": 2,
  "players": [
    {
      "age": 31,
      "college": "Texas Tech",
      "experience": 10,
      "group": "Offense",
      "height": "6' 2\"",
      "height_inches": 74,
      "id": 1197,
      "image": "https://media.api-sports.io/american-football/players/1197.png",
      "name": "Patrick Mahomes",
      "number": 15,
      "position": "QB",
      "weight_pounds": 225
    },
    {
      "age": null,
      "college": "USC",
      "experience": 10,
      "group": "Offense",
      "height": null,
      "height_inches": null,
      "id": 1209,
      "image": "https://media.api-sports.io/american-football/players/1209.png",
      "name": "JuJu Smith-Schuster",
      "number": 8,
      "position": "WR",
      "weight_pounds": 215
    }
  ]
}

Find teams

Find NFL and college teams by name, code, ID, or league and season, each with its logo and, for an NFL club, its code, city, owner, stadium and founding year. The NFL's list includes the AFC and NFC Pro Bowl sides.

Inputs

Teamteam_idtext: Optional. Only this team. Pick an NFL club from the list, or pass a team ID such as 17 for the Kansas City Chiefs (Find teams looks up college teams' IDs).
Searchsearchtext: Optional. Only names containing this, at least 3 characters.
Codecodetext: Optional. Only the team with this code, such as KC.
Leagueleague_idtext: Optional. Only this league: the NFL, or the NCAA for college football. Needs a season or a date too.One of: 1 (NFL), 2 (NCAA).
Seasonseasonnumber: Optional. Only this season, as the year it starts in, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

countnumber: How many came back.
teamslist: The teams.

Example output

{
  "count": 2,
  "teams": [
    {
      "city": "Philadelphia",
      "code": "PHI",
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "established": 1933,
      "id": 12,
      "logo": "https://media.api-sports.io/american-football/teams/12.png",
      "name": "Philadelphia Eagles",
      "owner": "Jeffrey Lurie",
      "stadium": "Lincoln Financial Field"
    },
    {
      "city": "Kansas City",
      "code": "KC",
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "established": 1960,
      "id": 17,
      "logo": "https://media.api-sports.io/american-football/teams/17.png",
      "name": "Kansas City Chiefs",
      "owner": "Clark Hunt",
      "stadium": "GEHA Field at Arrowhead Stadium"
    }
  ]
}

Get a game

Get one game by ID: its stage and week, venue, status, and both sides' points by quarter and in overtime.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 13466 for the 2024 season's Super Bowl. List games returns them; a game read by ID is open in any season on the free plan.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as America/New_York or America/Chicago. UTC when left empty.

Outputs

countryobject: The country.
datetext: The day it starts, YYYY-MM-DD, in the time zone.
idnumber: The game's ID.
leagueobject: The league, and the season this is from.
scoresobject: Each side's points by quarter and in all.
stagetext: Pre Season, Regular Season or Post Season, or an NCAA division such as FBS (Division I-A).
statusobject: Where the game stands.
teamsobject: Both sides.
timetext: Its start time, HH:MM, in that time zone.
timestampnumber: When it starts, as a Unix timestamp.
timezonetext: The time zone date and time are given in.
venueobject: Where it is played; null for most college games.
weektext: The week or round, such as Week 4, Wild Card or Super Bowl.

Example output

{
  "country": {
    "code": "US",
    "flag": "https://media.api-sports.io/flags/us.svg",
    "name": "USA"
  },
  "date": "2025-02-09",
  "id": 13466,
  "league": {
    "id": 1,
    "logo": "https://media.api-sports.io/american-football/leagues/1.png",
    "name": "NFL",
    "season": 2024
  },
  "scores": {
    "away": {
      "overtime": null,
      "quarter_1": 0,
      "quarter_2": 0,
      "quarter_3": 6,
      "quarter_4": 16,
      "total": 22
    },
    "home": {
      "overtime": null,
      "quarter_1": 7,
      "quarter_2": 17,
      "quarter_3": 10,
      "quarter_4": 6,
      "total": 40
    }
  },
  "stage": "Post Season",
  "status": {
    "long": "Finished",
    "short": "FT",
    "timer": null
  },
  "teams": {
    "away": {
      "id": 17,
      "logo": "https://media.api-sports.io/american-football/teams/17.png",
      "name": "Kansas City Chiefs"
    },
    "home": {
      "id": 12,
      "logo": "https://media.api-sports.io/american-football/teams/12.png",
      "name": "Philadelphia Eagles"
    }
  },
  "time": "23:30",
  "timestamp": 1739143800,
  "timezone": "UTC",
  "venue": {
    "city": "New Orleans",
    "name": "Caesars Superdome"
  },
  "week": "Super Bowl"
}

Get account status

See the connected key's API-NFL plan, when it renews, and how many of today's requests are used and left. It is free: it never counts against the day.

Inputs

None.

Outputs

activetrue/false: True while the subscription is active.
daily_limitnumber: Requests allowed a day.
plantext: The plan, such as Free.
requests_remainingnumber: Requests left today; the day starts at midnight UTC.
requests_todaynumber: Requests used today.
subscription_endtext: When the plan renews or ends.

Example output

{
  "active": true,
  "daily_limit": 100,
  "plan": "Free",
  "requests_remaining": 88,
  "requests_today": 12,
  "subscription_end": "2027-10-01T00:00:00+00:00"
}

Get player box scores

Get every player's box score for a game, or one group's, team's or player's: passing, rushing, receiving, fumbles, interceptions, defense, kick and punt returns, kicking and punting, each figure a number.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 13466 for the 2024 season's Super Bowl. List games returns them; a game read by ID is open in any season on the free plan.
Groupgrouptext: Optional. Only this group's figures, such as Passing.One of: passing, rushing, receiving, fumbles, interceptions, defensive (Defense), kick_returns (Kick returns), punt_returns (Punt returns), kicking, punting.
Teamteam_idtext: Optional. Only this team. Pick an NFL club from the list, or pass a team ID such as 17 for the Kansas City Chiefs (Find teams looks up college teams' IDs).
Player IDplayer_idtext: Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up.

Outputs

countnumber: How many came back.
game_idnumber: The game asked about.
playerslist: Each player's box score, team by team.

Example output

{
  "count": 5,
  "game_id": 13466,
  "players": [
    {
      "defensive": null,
      "fumbles": null,
      "interceptions": null,
      "kick_returns": null,
      "kicking": null,
      "passing": {
        "attempts": 22,
        "completions": 17,
        "interceptions": 1,
        "rating": 75.4,
        "sack_yards_lost": 11,
        "sacks": 2,
        "touchdowns": 2,
        "two_point_conversions": 0,
        "yards": 221,
        "yards_per_attempt": 10.0
      },
      "player": {
        "id": 830,
        "image": "https://media.api-sports.io/american-football/players/830.png",
        "name": "Jalen Hurts"
      },
      "punt_returns": null,
      "punting": null,
      "receiving": null,
      "rushing": {
        "attempts": 11,
        "longest": 17,
        "touchdowns": 1,
        "two_point_conversions": 0,
        "yards": 72,
        "yards_per_rush": 6.5
      },
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/american-football/teams/12.png",
        "name": "Philadelphia Eagles"
      }
    },
    {
      "defensive": null,
      "fumbles": null,
      "interceptions": null,
      "kick_returns": null,
      "kicking": {
        "extra_points_attempted": 4,
        "extra_points_made": 4,
        "field_goal_percentage": 100.0,
        "field_goals_attempted": 4,
        "field_goals_made": 4,
        "longest": 50,
        "made_20_to_29": 1,
        "made_30_to_39": 0,
        "made_40_to_49": 2,
        "made_50_plus": 1,
        "made_under_20": 0,
        "points": 16
      },
      "passing": null,
      "player": {
        "id": 899,
        "image": "https://media.api-sports.io/american-football/players/899.png",
        "name": "Jake Elliott"
      },
      "punt_returns": null,
      "punting": null,
      "receiving": null,
      "rushing": null,
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/american-football/teams/12.png",
        "name": "Philadelphia Eagles"
      }
    },
    {
      "defensive": null,
      "fumbles": null,
      "interceptions": null,
      "kick_returns": null,
      "kicking": null,
      "passing": {
        "attempts": 32,
        "completions": 21,
        "interceptions": 2,
        "rating": 11.4,
        "sack_yards_lost": 31,
        "sacks": 6,
        "touchdowns": 3,
        "two_point_conversions": 2,
        "yards": 257,
        "yards_per_attempt": 8.0
      },
      "player": {
        "id": 1197,
        "image": "https://media.api-sports.io/american-football/players/1197.png",
        "name": "Patrick Mahomes"
      },
      "punt_returns": null,
      "punting": null,
      "receiving": null,
      "rushing": null,
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      }
    },
    {
      "defensive": null,
      "fumbles": null,
      "interceptions": null,
      "kick_returns": null,
      "kicking": null,
      "passing": null,
      "player": {
        "id": 24401,
        "image": "https://media.api-sports.io/american-football/players/24401.png",
        "name": "Xavier Worthy"
      },
      "punt_returns": null,
      "punting": null,
      "receiving": {
        "longest": 50,
        "receptions": 8,
        "targets": 8,
        "touchdowns": 2,
        "two_point_conversions": 0,
        "yards": 157,
        "yards_per_reception": 19.6
      },
      "rushing": null,
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      }
    },
    {
      "defensive": {
        "blocked_kicks": 0,
        "forced_fumbles": 0,
        "interception_touchdowns": 0,
        "kick_return_touchdowns": 0,
        "passes_defended": 0,
        "quarterback_hits": 1,
        "sacks": 1,
        "solo_tackles": 7,
        "tackles": 11,
        "tackles_for_loss": 2
      },
      "fumbles": null,
      "interceptions": null,
      "kick_returns": null,
      "kicking": null,
      "passing": null,
      "player": {
        "id": 2207,
        "image": "https://media.api-sports.io/american-football/players/2207.png",
        "name": "Drue Tranquill"
      },
      "punt_returns": null,
      "punting": null,
      "receiving": null,
      "rushing": null,
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      }
    }
  ]
}

Get player season statistics

Get a player's season statistics, or those of every player on a team: passing, rushing, receiving, scoring, defense, returns, punting and kicking, each figure a number. On file from the 2022 season.

Inputs

Player IDplayer_idtext: Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up.
Teamteam_idtext: Optional. Every player on this team. Set this or a player. Pick an NFL club from the list, or pass a team ID.
SeasonseasonnumberRequired: The season, as the year it starts in, such as 2024 for the season ending in the February 2025 Super Bowl. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

countnumber: How many came back.
playerslist: Each player's season, one line per team they played for.

Example output

{
  "count": 1,
  "players": [
    {
      "defense": null,
      "kicking": null,
      "passing": {
        "attempts": 581,
        "completion_percentage": 67.5,
        "completions": 392,
        "interceptions": 11,
        "longest": 54,
        "rating": 93.5,
        "sack_yards_lost": 239,
        "sacks": 36,
        "touchdowns": 26,
        "yards": 3928,
        "yards_per_attempt": 6.8,
        "yards_per_game": 245.5
      },
      "player": {
        "id": 1197,
        "image": "https://media.api-sports.io/american-football/players/1197.png",
        "name": "Patrick Mahomes"
      },
      "punting": null,
      "receiving": {
        "first_downs": 0,
        "fumbles": 0,
        "fumbles_lost": 0,
        "longest": 2,
        "receptions": 1,
        "receptions_over_20_yards": 0,
        "targets": 1,
        "touchdowns": 0,
        "yards": 2,
        "yards_after_catch": 3,
        "yards_per_game": 0.1,
        "yards_per_reception": 2.0
      },
      "returning": null,
      "rushing": {
        "attempts": 58,
        "first_downs": 22,
        "fumbles": 1,
        "fumbles_lost": 0,
        "longest": 33,
        "runs_over_20_yards": 2,
        "touchdowns": 2,
        "yards": 307,
        "yards_per_game": 19.2,
        "yards_per_rush": 5.3
      },
      "scoring": {
        "extra_points": 0,
        "field_goals": 0,
        "points": 12,
        "points_per_game": 0.8,
        "receiving_touchdowns": 0,
        "return_touchdowns": 0,
        "rushing_touchdowns": 2,
        "touchdowns": 2,
        "two_point_conversions": 0
      },
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      }
    }
  ]
}

Get pre-match odds

Get bookmakers' pre-match odds for a game, optionally from one bookmaker or for one bet type. Odds appear 1 to 7 days before a game, are updated four times a day and are kept for 7 days.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 21561. List games returns them.
Bookmakerbookmaker_idtext: Optional. Only this bookmaker's odds. Pick one from the list.
Bet typebet_idtext: Optional. Only this kind of bet, such as Home/Away. Pick one from the list.

Outputs

countnumber: How many came back.
oddslist: The game's odds.

Example output

{
  "count": 1,
  "odds": [
    {
      "bookmakers": [
        {
          "bets": [
            {
              "id": 1,
              "name": "Home/Away",
              "values": [
                {
                  "odd": 2.25,
                  "value": "Home"
                },
                {
                  "odd": 1.66,
                  "value": "Away"
                }
              ]
            },
            {
              "id": 3,
              "name": "Over/Under",
              "values": [
                {
                  "odd": 1.03,
                  "value": "Over 19.5"
                },
                {
                  "odd": 9.7,
                  "value": "Under 19.5"
                }
              ]
            }
          ],
          "id": 4,
          "name": "Bet365"
        }
      ],
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "game_id": 21561,
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2026
      },
      "updated": "2026-10-01T00:00:06+00:00"
    }
  ]
}

Get scoring plays

Get a game's scoring plays in order: the quarter and clock, the side and player, the kind of score, the play as written (such as Patrick Mahomes 15 Yd Rush) and the score after it.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 13466 for the 2024 season's Super Bowl. List games returns them; a game read by ID is open in any season on the free plan.

Outputs

countnumber: How many came back.
eventslist: Its scoring plays, in order.
game_idnumber: The game asked about.

Example output

{
  "count": 3,
  "events": [
    {
      "clock": "6:15",
      "comment": "Jalen Hurts 1 Yd Rush (Jake Elliott Kick)",
      "player": {
        "id": 830,
        "image": "https://media.api-sports.io/american-football/players/830.png",
        "name": "Jalen Hurts"
      },
      "quarter": "First",
      "score": {
        "away": 0,
        "home": 7
      },
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/american-football/teams/12.png",
        "name": "Philadelphia Eagles"
      },
      "type": "TD"
    },
    {
      "clock": "8:38",
      "comment": "Jake Elliott 48 Yd Field Goal",
      "player": {
        "id": 893,
        "image": "https://media.api-sports.io/american-football/players/893.png",
        "name": "Darius Slay"
      },
      "quarter": "Second",
      "score": {
        "away": 0,
        "home": 10
      },
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/american-football/teams/12.png",
        "name": "Philadelphia Eagles"
      },
      "type": "FG"
    },
    {
      "clock": "7:03",
      "comment": "Cooper DeJean 38 Yd Interception Return (Jake Elliott Kick)",
      "player": {
        "id": 17856,
        "image": "https://media.api-sports.io/american-football/players/17856.png",
        "name": "Cooper DeJean"
      },
      "quarter": "Second",
      "score": {
        "away": 0,
        "home": 17
      },
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/american-football/teams/12.png",
        "name": "Philadelphia Eagles"
      },
      "type": "TD"
    }
  ],
  "game_id": 13466
}

Get standings

Get a season's standings, one table per division: each team's place, wins, losses and ties, win percentage, points for and against, home, road, conference and division records, and streak. Narrow to one conference, division or team.

Inputs

Leagueleague_idtextRequired: The league: the NFL, or the NCAA for college football.One of: 1 (NFL), 2 (NCAA).
SeasonseasonnumberRequired: The season, as the year it starts in, such as 2024 for the season ending in the February 2025 Super Bowl. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Teamteam_idtext: Optional. Only this team's line. Pick an NFL club from the list, or pass a team ID.
Conferenceconferencetext: Optional. Only this conference, by name, such as American Football Conference. List conferences gives a season's.
Divisiondivisiontext: Optional. Only this division, by the season's own name for it, such as AFC East. List divisions gives a season's.

Outputs

countnumber: How many came back.
standingslist: The tables, in the API's order.

Example output

{
  "count": 2,
  "standings": [
    {
      "conference": "American Football Conference",
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "division": "AFC West",
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2024
      },
      "table": [
        {
          "losses": 2,
          "points": {
            "against": 326,
            "difference": 59,
            "for": 385
          },
          "position": 1,
          "records": {
            "conference": {
              "losses": 2,
              "ties": 0,
              "wins": 10
            },
            "division": {
              "losses": 1,
              "ties": 0,
              "wins": 5
            },
            "home": {
              "losses": 0,
              "ties": 0,
              "wins": 8
            },
            "road": {
              "losses": 2,
              "ties": 0,
              "wins": 7
            }
          },
          "streak": "L1",
          "team": {
            "id": 17,
            "logo": "https://media.api-sports.io/american-football/teams/17.png",
            "name": "Kansas City Chiefs"
          },
          "ties": 0,
          "win_percentage": 0.882,
          "wins": 15
        },
        {
          "losses": 6,
          "points": {
            "against": 301,
            "difference": 101,
            "for": 402
          },
          "position": 2,
          "records": {
            "conference": {
              "losses": 4,
              "ties": 0,
              "wins": 8
            },
            "division": {
              "losses": 2,
              "ties": 0,
              "wins": 4
            },
            "home": {
              "losses": 3,
              "ties": 0,
              "wins": 5
            },
            "road": {
              "losses": 3,
              "ties": 0,
              "wins": 6
            }
          },
          "streak": "W3",
          "team": {
            "id": 30,
            "logo": "https://media.api-sports.io/american-football/teams/30.png",
            "name": "Los Angeles Chargers"
          },
          "ties": 0,
          "win_percentage": 0.647,
          "wins": 11
        }
      ]
    },
    {
      "conference": "National Football Conference",
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "division": "NFC East",
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2024
      },
      "table": [
        {
          "losses": 3,
          "points": {
            "against": 303,
            "difference": 160,
            "for": 463
          },
          "position": 1,
          "records": {
            "conference": {
              "losses": 3,
              "ties": 0,
              "wins": 9
            },
            "division": {
              "losses": 1,
              "ties": 0,
              "wins": 5
            },
            "home": {
              "losses": 1,
              "ties": 0,
              "wins": 8
            },
            "road": {
              "losses": 2,
              "ties": 0,
              "wins": 6
            }
          },
          "streak": "W2",
          "team": {
            "id": 12,
            "logo": "https://media.api-sports.io/american-football/teams/12.png",
            "name": "Philadelphia Eagles"
          },
          "ties": 0,
          "win_percentage": 0.824,
          "wins": 14
        },
        {
          "losses": 5,
          "points": {
            "against": 391,
            "difference": 94,
            "for": 485
          },
          "position": 2,
          "records": {
            "conference": {
              "losses": 3,
              "ties": 0,
              "wins": 9
            },
            "division": {
              "losses": 2,
              "ties": 0,
              "wins": 4
            },
            "home": {
              "losses": 2,
              "ties": 0,
              "wins": 7
            },
            "road": {
              "losses": 3,
              "ties": 0,
              "wins": 5
            }
          },
          "streak": "W5",
          "team": {
            "id": 18,
            "logo": "https://media.api-sports.io/american-football/teams/18.png",
            "name": "Washington Commanders"
          },
          "ties": 0,
          "win_percentage": 0.706,
          "wins": 12
        }
      ]
    }
  ]
}

Get team box scores

Get both teams' box scores for a game, or one team's: first downs, third and fourth downs, plays and yards, passing and rushing, red zone trips, penalties, turnovers, time of possession, and its defense's interceptions, sacks and points allowed.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 13466 for the 2024 season's Super Bowl. List games returns them; a game read by ID is open in any season on the free plan.
Teamteam_idtext: Optional. Only this team. Pick an NFL club from the list, or pass a team ID such as 17 for the Kansas City Chiefs (Find teams looks up college teams' IDs).

Outputs

countnumber: How many came back.
game_idnumber: The game asked about.
teamslist: Each side's box score.

Example output

{
  "count": 2,
  "game_id": 13466,
  "teams": [
    {
      "drives": 13,
      "first_downs": {
        "from_penalties": 3,
        "passing": 11,
        "rushing": 7,
        "total": 21
      },
      "fourth_downs": {
        "attempts": 1,
        "made": 0
      },
      "fumbles_recovered": 1,
      "interception_touchdowns": 1,
      "interceptions": 2,
      "passing": {
        "attempts": 23,
        "completions": 17,
        "interceptions_thrown": 1,
        "net_yards": 210,
        "sack_yards_lost": 11,
        "sacked": 2,
        "yards_per_pass": 8.4
      },
      "penalties": {
        "count": 8,
        "yards": 59
      },
      "plays": 70,
      "points_against": 22,
      "possession": "36:58",
      "red_zone": {
        "attempts": 3,
        "made": 2
      },
      "rushing": {
        "attempts": 45,
        "yards": 135,
        "yards_per_rush": 3.0
      },
      "sacks": 6,
      "safeties": 0,
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/american-football/teams/12.png",
        "name": "Philadelphia Eagles"
      },
      "third_downs": {
        "attempts": 12,
        "made": 3
      },
      "total_yards": 345,
      "turnovers": {
        "fumbles_lost": 0,
        "interceptions": 1,
        "total": 1
      },
      "yards_per_play": 4.9
    },
    {
      "drives": 13,
      "first_downs": {
        "from_penalties": 0,
        "passing": 11,
        "rushing": 1,
        "total": 12
      },
      "fourth_downs": {
        "attempts": 1,
        "made": 0
      },
      "fumbles_recovered": 0,
      "interception_touchdowns": 0,
      "interceptions": 1,
      "passing": {
        "attempts": 32,
        "completions": 21,
        "interceptions_thrown": 2,
        "net_yards": 226,
        "sack_yards_lost": 31,
        "sacked": 6,
        "yards_per_pass": 5.9
      },
      "penalties": {
        "count": 7,
        "yards": 75
      },
      "plays": 49,
      "points_against": 40,
      "possession": "23:02",
      "red_zone": {
        "attempts": 1,
        "made": 1
      },
      "rushing": {
        "attempts": 11,
        "yards": 49,
        "yards_per_rush": 4.5
      },
      "sacks": 2,
      "safeties": 0,
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      },
      "third_downs": {
        "attempts": 11,
        "made": 3
      },
      "total_yards": 275,
      "turnovers": {
        "fumbles_lost": 1,
        "interceptions": 2,
        "total": 3
      },
      "yards_per_play": 5.6
    }
  ]
}

List bet types

List the kinds of bet API-NFL has odds for, such as Home/Away, Asian Handicap or Over/Under, with the IDs the odds filter takes.

Inputs

Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

betslist: The bet types.
countnumber: How many came back.

Example output

{
  "bets": [
    {
      "id": 1,
      "name": "Home/Away"
    },
    {
      "id": 2,
      "name": "Asian Handicap"
    }
  ],
  "count": 2
}

List bookmakers

List the bookmakers API-NFL has odds from, with the IDs the odds filter takes. These IDs are API-NFL's own: the same bookmaker can have another ID in another API-SPORTS API.

Inputs

Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

bookmakerslist: The bookmakers.
countnumber: How many came back.

Example output

{
  "bookmakers": [
    {
      "id": 1,
      "name": "Bwin"
    },
    {
      "id": 4,
      "name": "Bet365"
    }
  ],
  "count": 2
}

List conferences

List a season's conferences, such as the NFL's American and National Football Conferences, by the names Get standings takes.

Inputs

Leagueleague_idtextRequired: The league: the NFL, or the NCAA for college football.One of: 1 (NFL), 2 (NCAA).
SeasonseasonnumberRequired: The season, as the year it starts in, such as 2024 for the season ending in the February 2025 Super Bowl. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

conferenceslist: The conferences, by name.
countnumber: How many came back.

Example output

{
  "conferences": [
    "American Football Conference",
    "National Football Conference"
  ],
  "count": 2
}

List divisions

List a season's divisions, such as AFC East, by the names Get standings takes. The names change between seasons (2022's are East, North, South and West).

Inputs

Leagueleague_idtextRequired: The league: the NFL, or the NCAA for college football.One of: 1 (NFL), 2 (NCAA).
SeasonseasonnumberRequired: The season, as the year it starts in, such as 2024 for the season ending in the February 2025 Super Bowl. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

countnumber: How many came back.
divisionslist: The divisions, by name.

Example output

{
  "count": 8,
  "divisions": [
    "AFC East",
    "AFC North",
    "AFC South",
    "AFC West",
    "NFC East",
    "NFC North",
    "NFC South",
    "NFC West"
  ]
}

List games

List games and results by day, by league or team and season, or every game in play, each with its stage and week, venue, status, and both sides' points by quarter and in overtime.

Inputs

Dateon_datedate: Optional. Only games on this day, in the time zone chosen below. The free plan takes only yesterday, today or tomorrow.
Leagueleague_idtext: Optional. Only this league: the NFL, or the NCAA for college football. Needs a season or a date too.One of: 1 (NFL), 2 (NCAA).
Seasonseasonnumber: Optional. Only this season, as the year it starts in, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Teamteam_idtext: Optional. Only this team's games; needs a season or a date too. Pick an NFL club from the list, or pass a team ID.
In playlivetrue/false: Optional. Only the games the API has in play right now.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as America/New_York or America/Chicago. UTC when left empty.

Outputs

countnumber: How many came back.
gameslist: The games, in the order given.

Example output

{
  "count": 2,
  "games": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "date": "2025-02-09",
      "id": 13466,
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2024
      },
      "scores": {
        "away": {
          "overtime": null,
          "quarter_1": 0,
          "quarter_2": 0,
          "quarter_3": 6,
          "quarter_4": 16,
          "total": 22
        },
        "home": {
          "overtime": null,
          "quarter_1": 7,
          "quarter_2": 17,
          "quarter_3": 10,
          "quarter_4": 6,
          "total": 40
        }
      },
      "stage": "Post Season",
      "status": {
        "long": "Finished",
        "short": "FT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 17,
          "logo": "https://media.api-sports.io/american-football/teams/17.png",
          "name": "Kansas City Chiefs"
        },
        "home": {
          "id": 12,
          "logo": "https://media.api-sports.io/american-football/teams/12.png",
          "name": "Philadelphia Eagles"
        }
      },
      "time": "23:30",
      "timestamp": 1739143800,
      "timezone": "UTC",
      "venue": {
        "city": "New Orleans",
        "name": "Caesars Superdome"
      },
      "week": "Super Bowl"
    },
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "date": "2024-11-05",
      "id": 13323,
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2024
      },
      "scores": {
        "away": {
          "overtime": 0,
          "quarter_1": 0,
          "quarter_2": 7,
          "quarter_3": 10,
          "quarter_4": 7,
          "total": 24
        },
        "home": {
          "overtime": 6,
          "quarter_1": 3,
          "quarter_2": 7,
          "quarter_3": 0,
          "quarter_4": 14,
          "total": 30
        }
      },
      "stage": "Regular Season",
      "status": {
        "long": "Final/OT",
        "short": "AOT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 24,
          "logo": "https://media.api-sports.io/american-football/teams/24.png",
          "name": "Tampa Bay Buccaneers"
        },
        "home": {
          "id": 17,
          "logo": "https://media.api-sports.io/american-football/teams/17.png",
          "name": "Kansas City Chiefs"
        }
      },
      "time": "01:15",
      "timestamp": 1730769300,
      "timezone": "UTC",
      "venue": {
        "city": "Kansas City",
        "name": "GEHA Field at Arrowhead Stadium"
      },
      "week": "Week 9"
    }
  ]
}

List head-to-head games

List the games two teams have played each other, in every season or one, games to come included, with a count of each side's wins and points across the finished ones.

Inputs

First teamfirst_team_idtextRequired: One of the two teams. The summary counts its wins first. Pick an NFL club from the list, or pass a team ID.
Second teamsecond_team_idtextRequired: The other team. Pick an NFL club from the list, or pass a team ID.
Seasonseasonnumber: Optional. Only this season, such as 2024. The free plan reads the 2022 to 2024 seasons; left empty, it reads every season, games to come included.From 1900 to 2100.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as America/New_York or America/Chicago. UTC when left empty.

Outputs

countnumber: How many came back.
gameslist: Their games, oldest first.
summaryobject: A count of the finished games among them, overtime included.

Example output

{
  "count": 2,
  "games": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "date": "2024-11-10",
      "id": 13328,
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2024
      },
      "scores": {
        "away": {
          "overtime": null,
          "quarter_1": 0,
          "quarter_2": 14,
          "quarter_3": 0,
          "quarter_4": 0,
          "total": 14
        },
        "home": {
          "overtime": null,
          "quarter_1": 0,
          "quarter_2": 10,
          "quarter_3": 3,
          "quarter_4": 3,
          "total": 16
        }
      },
      "stage": "Regular Season",
      "status": {
        "long": "Finished",
        "short": "FT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 28,
          "logo": "https://media.api-sports.io/american-football/teams/28.png",
          "name": "Denver Broncos"
        },
        "home": {
          "id": 17,
          "logo": "https://media.api-sports.io/american-football/teams/17.png",
          "name": "Kansas City Chiefs"
        }
      },
      "time": "18:00",
      "timestamp": 1731261600,
      "timezone": "UTC",
      "venue": {
        "city": "Kansas City",
        "name": "GEHA Field at Arrowhead Stadium"
      },
      "week": "Week 10"
    },
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "date": "2025-01-05",
      "id": 13444,
      "league": {
        "id": 1,
        "logo": "https://media.api-sports.io/american-football/leagues/1.png",
        "name": "NFL",
        "season": 2024
      },
      "scores": {
        "away": {
          "overtime": null,
          "quarter_1": 0,
          "quarter_2": 0,
          "quarter_3": 0,
          "quarter_4": 0,
          "total": 0
        },
        "home": {
          "overtime": null,
          "quarter_1": 14,
          "quarter_2": 10,
          "quarter_3": 7,
          "quarter_4": 7,
          "total": 38
        }
      },
      "stage": "Regular Season",
      "status": {
        "long": "Finished",
        "short": "FT",
        "timer": null
      },
      "teams": {
        "away": {
          "id": 17,
          "logo": "https://media.api-sports.io/american-football/teams/17.png",
          "name": "Kansas City Chiefs"
        },
        "home": {
          "id": 28,
          "logo": "https://media.api-sports.io/american-football/teams/28.png",
          "name": "Denver Broncos"
        }
      },
      "time": "21:25",
      "timestamp": 1736112300,
      "timezone": "UTC",
      "venue": {
        "city": "Denver",
        "name": "Empower Field at Mile High"
      },
      "week": "Week 18"
    }
  ],
  "summary": {
    "first_team_points": 16,
    "first_team_wins": 1,
    "played": 2,
    "second_team_points": 52,
    "second_team_wins": 1,
    "ties": 0
  }
}

List injuries

List the players injured now on a team, or one player's injury: the injury, their status (such as Questionable or Out) and when it was reported. The API keeps no history.

Inputs

Teamteam_idtext: Optional. This team's injured players. Set this or a player. Pick an NFL club from the list, or pass a team ID.
Player IDplayer_idtext: Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up.

Outputs

countnumber: How many came back.
injurieslist: The injured players.

Example output

{
  "count": 2,
  "injuries": [
    {
      "date": "2026-09-28",
      "description": "I.L. - Knee - ACL",
      "player": {
        "id": 15395,
        "image": "https://media.api-sports.io/american-football/players/15395.png",
        "name": "Ethan Downs"
      },
      "status": "I.L.",
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      }
    },
    {
      "date": "2026-09-28",
      "description": "Back - Questionable for Week 4 at Las Vegas",
      "player": {
        "id": 19796,
        "image": "https://media.api-sports.io/american-football/players/19796.png",
        "name": "Josh Simmons"
      },
      "status": "Questionable",
      "team": {
        "id": 17,
        "logo": "https://media.api-sports.io/american-football/teams/17.png",
        "name": "Kansas City Chiefs"
      }
    }
  ]
}

List leagues

List the two leagues API-NFL covers, the NFL and the NCAA (college football), each with every season on file, its dates, and what the API has for it: scoring plays, box scores, season statistics, injuries and standings.

Inputs

Leagueleague_idtext: Optional. Only this league: the NFL or the NCAA.One of: 1 (NFL), 2 (NCAA).
Seasonseasonnumber: Optional. Only this season, as the year it starts in, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Current season onlycurrenttrue/false: Optional. Only each league's season under way, or every season but that one.

Outputs

countnumber: How many came back.
leagueslist: The leagues.

Example output

{
  "count": 2,
  "leagues": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "current_season": {
        "coverage": {
          "injuries": true,
          "player_box_scores": true,
          "player_season_statistics": true,
          "players": true,
          "scoring_plays": true,
          "standings": true,
          "team_box_scores": true
        },
        "current": true,
        "end": "2027-02-14",
        "season": 2026,
        "start": "2026-08-07"
      },
      "id": 1,
      "logo": "https://media.api-sports.io/american-football/leagues/1.png",
      "name": "NFL",
      "seasons": [
        {
          "coverage": {
            "injuries": false,
            "player_box_scores": true,
            "player_season_statistics": true,
            "players": true,
            "scoring_plays": true,
            "standings": true,
            "team_box_scores": true
          },
          "current": false,
          "end": "2025-02-09",
          "season": 2024,
          "start": "2024-08-02"
        },
        {
          "coverage": {
            "injuries": false,
            "player_box_scores": true,
            "player_season_statistics": true,
            "players": true,
            "scoring_plays": true,
            "standings": true,
            "team_box_scores": true
          },
          "current": false,
          "end": "2026-02-08",
          "season": 2025,
          "start": "2025-08-01"
        },
        {
          "coverage": {
            "injuries": true,
            "player_box_scores": true,
            "player_season_statistics": true,
            "players": true,
            "scoring_plays": true,
            "standings": true,
            "team_box_scores": true
          },
          "current": true,
          "end": "2027-02-14",
          "season": 2026,
          "start": "2026-08-07"
        }
      ]
    },
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "name": "USA"
      },
      "current_season": {
        "coverage": {
          "injuries": true,
          "player_box_scores": true,
          "player_season_statistics": true,
          "players": true,
          "scoring_plays": true,
          "standings": true,
          "team_box_scores": true
        },
        "current": true,
        "end": "2027-01-26",
        "season": 2026,
        "start": "2026-08-27"
      },
      "id": 2,
      "logo": "https://media.api-sports.io/american-football/leagues/2.png",
      "name": "NCAA",
      "seasons": [
        {
          "coverage": {
            "injuries": false,
            "player_box_scores": true,
            "player_season_statistics": true,
            "players": true,
            "scoring_plays": true,
            "standings": true,
            "team_box_scores": true
          },
          "current": false,
          "end": "2025-01-21",
          "season": 2024,
          "start": "2024-08-24"
        },
        {
          "coverage": {
            "injuries": true,
            "player_box_scores": true,
            "player_season_statistics": true,
            "players": true,
            "scoring_plays": true,
            "standings": true,
            "team_box_scores": true
          },
          "current": false,
          "end": "2026-01-19",
          "season": 2025,
          "start": "2025-08-23"
        },
        {
          "coverage": {
            "injuries": true,
            "player_box_scores": true,
            "player_season_statistics": true,
            "players": true,
            "scoring_plays": true,
            "standings": true,
            "team_box_scores": true
          },
          "current": true,
          "end": "2027-01-26",
          "season": 2026,
          "start": "2026-08-27"
        }
      ]
    }
  ]
}

List seasons

List the seasons API-NFL has data for, oldest first, as the years the Season fields take. A season is named by the year it starts in: 2024 is the one whose Super Bowl was in February 2025.

Inputs

None.

Outputs

countnumber: How many came back.
seasonslist: The seasons, oldest first.

Example output

{
  "count": 5,
  "seasons": [
    2022,
    2023,
    2024,
    2025,
    2026
  ]
}

ActionsCopy Anchor Link

Find playersCopy Anchor Link

Inputs

Outputs

Find teamsCopy Anchor Link

Inputs

Outputs

Get a gameCopy Anchor Link

Inputs

Outputs

Get account statusCopy Anchor Link

Inputs

Outputs

Get player box scoresCopy Anchor Link

Inputs

Outputs

Get player season statisticsCopy Anchor Link

Inputs

Outputs

Get pre-match oddsCopy Anchor Link

Inputs

Outputs

Get scoring playsCopy Anchor Link

Inputs

Outputs

Get standingsCopy Anchor Link

Inputs

Outputs

Get team box scoresCopy Anchor Link

Inputs

Outputs

List bet typesCopy Anchor Link

Inputs

Outputs

List bookmakersCopy Anchor Link

Inputs

Outputs

List conferencesCopy Anchor Link

Inputs

Outputs

List divisionsCopy Anchor Link

Inputs

Outputs

List gamesCopy Anchor Link

Inputs

Outputs

List head-to-head gamesCopy Anchor Link

Inputs

Outputs

List injuriesCopy Anchor Link

Inputs

Outputs

List leaguesCopy Anchor Link

Inputs

Outputs

List seasonsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Find players

Find teams

Get a game

Get account status

Get player box scores

Get player season statistics

Get pre-match odds

Get scoring plays

Get standings

Get team box scores

List bet types

List bookmakers

List conferences

List divisions

List games

List head-to-head games

List injuries

List leagues

List seasons