Sports API

Parameters

Provide league, unless you pass game_id or a team id such as nba-bos.

• league  optional

  nfl, nba or nhl.

• date  optional

  Game day in US Eastern time (YYYY-MM-DD). Defaults to today when no team or season is given.

• team  optional

  Team id, abbreviation or name (e.g. BOS): that team's games in the season.

• season  optional

  Season, as the year it starts (2026 = 2026-27). Defaults to the current season. On its own, returns the whole season.

• season_type  optional

  Only games of this part of the season.

• status  optional

  Only games with this status.

• game_id  optional

  Return one game.

• limit  optional Premium only

  Games per page (1-500). Default 50.

• offset  optional

  Games to skip, for paging. Default 0.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

The /v1/sportsgames endpoint returns a JSON array of games in start order, or an error.

• game_id

  Unique id of the game, e.g. nba-20261022-cle-phi. It never changes, even when a game is moved to another date.

• league

  nfl, nba or nhl.

• season

  Season, as the year it starts: 2026 is the 2026 NFL season and the 2026-27 NBA and NHL seasons.

• season_label

  Display form of the season, e.g. 2026 or 2026-27.

• season_type

  preseason, regular, cup_final (the NBA Cup championship game, which does not count in the standings), play_in (NBA) or postseason.

• week

  NFL only: week of the season.

• date

  Game day in US Eastern time (YYYY-MM-DD). A late game that starts after midnight UTC keeps its US date.

• start_time

  Scheduled start in UTC (ISO 8601).

• status

  scheduled, in_progress, final, postponed, canceled, suspended or delayed.

• status_detail Premium only

  During a game: halftime, end_of_period or intermission (NHL), otherwise null. While a game is in progress, the free plan sees This field is for premium subscribers only.

• period Premium only

  Current period, or the last one played once the game is final: quarters in the NFL and NBA, periods in the NHL. Overtime periods continue the count. While a game is in progress, the free plan sees This field is for premium subscribers only.

• clock Premium only

  Time left in the current period while the game is in progress, e.g. 5:33. The free plan sees This field is for premium subscribers only.

• home_team, away_team

  The teams: team_id, name and abbreviation, named as they were that season (e.g. the New Orleans Hornets or the Washington Redskins). A team that moved city, such as the Oakland Raiders, has its own team_id.

• home_score, away_score Premium only

  Current or final score; null before the game starts. While a game is in progress, the free plan sees This field is for premium subscribers only.

• period_scores Premium only

  Points or goals per period for home and away, including each overtime period. NHL shootout goals are not period goals: a shootout win shows in the final score and in decided_in. While a game is in progress, the free plan sees This field is for premium subscribers only.

• decided_in

  For final games: regulation, overtime or shootout (NHL).

• winner

  team_id of the winner once the game is final; null before that and for a tie.

• venue

  Where the game is played: name, city, state and country (ISO 3166-1 alpha-2).

• neutral_site

  true when neither team is at home, e.g. international games and the Super Bowl.

• original_date

  For a game moved to another date: the date it was first scheduled for. Otherwise null.

• updated_at

  When any field of the game last changed (UTC).

Parameters

• league  required

  nfl, nba or nhl.

• season  optional

  Season, as the year it starts. Defaults to the current season.

• conference  optional

  Only this conference, e.g. AFC, Eastern.

• division  optional

  Only this division, e.g. AFC East, Atlantic.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

The /v1/sportsstandings endpoint returns a JSON array of team rows, or an error. Fields that do not apply to a league are left out.

• league, season, season_label

  League and season of the table.

• team

  team_id, name and abbreviation, named as they were that season.

• conference, division

  The team's conference and division that season, including temporary alignments such as the NHL's 2020-21 divisions (when conference is null).

• games_played, wins, losses

  Record.

• ties

  NFL only.

• ot_losses, points, point_pct, regulation_wins

  NHL only: overtime and shootout losses, standings points, points percentage and regulation wins.

• win_pct, games_behind

  NFL and NBA: winning percentage and games behind the division leader.

• points_for, points_against, point_differential

  NFL and NBA.

• goals_for, goals_against, goal_differential

  NHL.

• streak

  Current streak, e.g. W2 or L1.

• home_record, away_record

  Home and road records, e.g. 4-1 (NHL: wins-losses-overtime losses).

• division_record, conference_record

  NFL and NBA: records against division and conference opponents.

• last_10

  NBA and NHL: record over the last 10 games.

• league_rank, conference_rank, division_rank

  Rank in the league, conference and division. In the NFL and NBA, conference_rank is the playoff seed.

• wildcard_rank, clinched

  NHL only: wild-card position and the clinching indicator the league publishes.

• final

  true once the regular season is over and the table no longer changes.

Parameters

• league  optional

  Only this league. Without it, every league is listed.

• team  optional

  Team id, abbreviation or name (e.g. BOS): return one team.

• conference  optional

  Only teams in this conference.

• division  optional

  Only teams in this division.

• active  optional

  false lists former teams that appear in past seasons.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

The /v1/sportsteams endpoint returns a JSON array of teams, or an error.

• team_id

  Unique id, e.g. nba-bos. Use it, the abbreviation or the name in other endpoints.

• league, abbreviation, name, nickname, city

  Identity of the team.

• conference, division

  Current conference and division.

• venue

  Home venue: name, city, state, country.

• active

  false for teams that have since moved, such as the Oakland Raiders, New Jersey Nets or Atlanta Thrashers, which still appear in past seasons.

Parameters

Provide league with team or name, or a player_id.

• league  optional

  nfl, nba or nhl.

• team  optional

  Team id, abbreviation or name: that team's current roster.

• name  optional

  Full or partial player name. Case and accents are ignored.

• player_id  optional

  Return one player.

• position  optional

  Only this position, e.g. G.

• limit  optional Premium only

  Players per page (1-500). Default 50.

• offset  optional

  Players to skip, for paging. Default 0.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

The /v1/sportsplayers endpoint returns a JSON array of players, or an error. League-specific fields are left out where they do not apply.

• player_id

  Unique id, e.g. nba-p-8f12176c56. It stays the same when a player changes teams.

• team

  Current team (team_id, name, abbreviation), or null when the player is on no roster.

• name, first_name, last_name

  Player name.

• position, jersey_number

  Position abbreviation and jersey number.

• height_in, height_cm, weight_lb, weight_kg

  Height and weight.

• birth_date, birth_place

  Date of birth and birthplace (city, state, country).

• roster_status

  active, reserve (NFL injured reserve and similar lists), practice_squad (NFL), suspended, or not_on_roster.

• college, experience_years

  NFL and NBA: college and years of professional experience.

• shoots_catches

  NHL only: L or R.