# 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. App · Sports · 19 actions. Web page: https://docs.lodol.com/docs/integrations/api-nfl ## Actions ### 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 ID (`player_id`, text): Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up. - Search (`search`, text): Optional. Only names containing this, at least 3 characters. - Team (`team_id`, text): Optional. Only this team's players; needs a season too. Pick an NFL club from the list, or pass a team ID. - Season (`season`, number): 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** - `count` (number): How many came back. - `players` (list): The players. **Example output** ```json { "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** - Team (`team_id`, text): 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). - Search (`search`, text): Optional. Only names containing this, at least 3 characters. - Code (`code`, text): Optional. Only the team with this code, such as KC. - League (`league_id`, text): 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). - Season (`season`, number): 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** - `count` (number): How many came back. - `teams` (list): The teams. **Example output** ```json { "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 ID (`game_id`, text, required): 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 zone (`timezone`, text): Optional. Give dates and times in this time zone, such as America/New_York or America/Chicago. UTC when left empty. **Outputs** - `country` (object): The country. - `date` (text): The day it starts, YYYY-MM-DD, in the time zone. - `id` (number): The game's ID. - `league` (object): The league, and the season this is from. - `scores` (object): Each side's points by quarter and in all. - `stage` (text): Pre Season, Regular Season or Post Season, or an NCAA division such as FBS (Division I-A). - `status` (object): Where the game stands. - `teams` (object): Both sides. - `time` (text): Its start time, HH:MM, in that time zone. - `timestamp` (number): When it starts, as a Unix timestamp. - `timezone` (text): The time zone date and time are given in. - `venue` (object): Where it is played; null for most college games. - `week` (text): The week or round, such as Week 4, Wild Card or Super Bowl. **Example output** ```json { "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** - `active` (true/false): True while the subscription is active. - `daily_limit` (number): Requests allowed a day. - `plan` (text): The plan, such as Free. - `requests_remaining` (number): Requests left today; the day starts at midnight UTC. - `requests_today` (number): Requests used today. - `subscription_end` (text): When the plan renews or ends. **Example output** ```json { "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 ID (`game_id`, text, required): 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. - Group (`group`, text): 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`. - Team (`team_id`, text): 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 ID (`player_id`, text): Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up. **Outputs** - `count` (number): How many came back. - `game_id` (number): The game asked about. - `players` (list): Each player's box score, team by team. **Example output** ```json { "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 ID (`player_id`, text): Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up. - Team (`team_id`, text): Optional. Every player on this team. Set this or a player. Pick an NFL club from the list, or pass a team ID. - Season (`season`, number, required): 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** - `count` (number): How many came back. - `players` (list): Each player's season, one line per team they played for. **Example output** ```json { "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 ID (`game_id`, text, required): The game's ID, such as 21561. List games returns them. - Bookmaker (`bookmaker_id`, text): Optional. Only this bookmaker's odds. Pick one from the list. - Bet type (`bet_id`, text): Optional. Only this kind of bet, such as Home/Away. Pick one from the list. **Outputs** - `count` (number): How many came back. - `odds` (list): The game's odds. **Example output** ```json { "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 ID (`game_id`, text, required): 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** - `count` (number): How many came back. - `events` (list): Its scoring plays, in order. - `game_id` (number): The game asked about. **Example output** ```json { "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** - League (`league_id`, text, required): The league: the NFL, or the NCAA for college football. One of: `1` (NFL), `2` (NCAA). - Season (`season`, number, required): 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. - Team (`team_id`, text): Optional. Only this team's line. Pick an NFL club from the list, or pass a team ID. - Conference (`conference`, text): Optional. Only this conference, by name, such as American Football Conference. List conferences gives a season's. - Division (`division`, text): Optional. Only this division, by the season's own name for it, such as AFC East. List divisions gives a season's. **Outputs** - `count` (number): How many came back. - `standings` (list): The tables, in the API's order. **Example output** ```json { "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 ID (`game_id`, text, required): 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. - Team (`team_id`, text): 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** - `count` (number): How many came back. - `game_id` (number): The game asked about. - `teams` (list): Each side's box score. **Example output** ```json { "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** - Search (`search`, text): Optional. Only names containing this, at least 3 characters. **Outputs** - `bets` (list): The bet types. - `count` (number): How many came back. **Example output** ```json { "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** - Search (`search`, text): Optional. Only names containing this, at least 3 characters. **Outputs** - `bookmakers` (list): The bookmakers. - `count` (number): How many came back. **Example output** ```json { "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** - League (`league_id`, text, required): The league: the NFL, or the NCAA for college football. One of: `1` (NFL), `2` (NCAA). - Season (`season`, number, required): 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** - `conferences` (list): The conferences, by name. - `count` (number): How many came back. **Example output** ```json { "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** - League (`league_id`, text, required): The league: the NFL, or the NCAA for college football. One of: `1` (NFL), `2` (NCAA). - Season (`season`, number, required): 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** - `count` (number): How many came back. - `divisions` (list): The divisions, by name. **Example output** ```json { "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** - Date (`on_date`, date): Optional. Only games on this day, in the time zone chosen below. The free plan takes only yesterday, today or tomorrow. - League (`league_id`, text): 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). - Season (`season`, number): 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. - Team (`team_id`, text): 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 play (`live`, true/false): Optional. Only the games the API has in play right now. - Time zone (`timezone`, text): Optional. Give dates and times in this time zone, such as America/New_York or America/Chicago. UTC when left empty. **Outputs** - `count` (number): How many came back. - `games` (list): The games, in the order given. **Example output** ```json { "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 team (`first_team_id`, text, required): One of the two teams. The summary counts its wins first. Pick an NFL club from the list, or pass a team ID. - Second team (`second_team_id`, text, required): The other team. Pick an NFL club from the list, or pass a team ID. - Season (`season`, number): 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 zone (`timezone`, text): Optional. Give dates and times in this time zone, such as America/New_York or America/Chicago. UTC when left empty. **Outputs** - `count` (number): How many came back. - `games` (list): Their games, oldest first. - `summary` (object): A count of the finished games among them, overtime included. **Example output** ```json { "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** - Team (`team_id`, text): Optional. This team's injured players. Set this or a player. Pick an NFL club from the list, or pass a team ID. - Player ID (`player_id`, text): Optional. Only this player, by ID, such as 1197 for Patrick Mahomes. Find players looks one up. **Outputs** - `count` (number): How many came back. - `injuries` (list): The injured players. **Example output** ```json { "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** - League (`league_id`, text): Optional. Only this league: the NFL or the NCAA. One of: `1` (NFL), `2` (NCAA). - Season (`season`, number): 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 only (`current`, true/false): Optional. Only each league's season under way, or every season but that one. **Outputs** - `count` (number): How many came back. - `leagues` (list): The leagues. **Example output** ```json { "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** - `count` (number): How many came back. - `seasons` (list): The seasons, oldest first. **Example output** ```json { "count": 5, "seasons": [ 2022, 2023, 2024, 2025, 2026 ] } ```