Version: 2.0.0

Game Scores

REQUIREMENT

You'll need a license key to use OddsJam's API. You can get one by emailing us at [email protected].

API Endpoint#

https://api-external.oddsjam.com/api/v2/scores

Supported Leagues#

NBA, NFL, NHL, MLB, NCAAB, NCAAF

Parameters#

key (required)#

Your OddsJam API license key.

sport#

NOTE

You can pass in multiple of this parameter.

The sport you want to receive scores for. We support the following:

  • football
  • basketball
  • baseball
  • mma
  • boxing
  • hockey
  • soccer
  • tennis
  • golf
  • motorsports
  • esports
  • wrestling
  • aussie-rules
  • rugby

league#

NOTE

You can pass in multiple of this parameter.

The league you want to receive scores for (e.g. NBA)

game_id#

NOTE

You can pass in multiple of this parameter.

The OddsJam game ID you want to receive scores for (e.g. 39341-78014-2022-01-17)

team_id#

NOTE

You can pass in multiple of this parameter.

The team ID you want to receive scores for (e.g. E89B6AABD4C6)

live#

Whether you want live scores or completed.

status#

Filter games by status, possible statuses are Live|Completed|Unplayed.

include_starting_lineups#

Set to true to include home_starting_lineups and away_starting_lineups.

include_team_ids#

Whether or not to include the team_id field on the odds returned, if there is no matching team id, this will default to null.

include_events#

For soccer, this will include major incidents (Yellow Cards, Goals, VAR).

page#

The page number of the request.

Example Response#

{
"data": [
{
"game_id": "29679-37994-2023-01-05",
"score_home_total": 18,
"score_away_total": 10,
"clock": "10:18",
"sport": "Basketball",
"league": "NCAAB",
"period": "1",
"status": "Live",
"is_live": true,
"weather": null,
"away_team": "USC",
"broadcast": "ESPN",
"home_team": "UCLA",
"last_play": "Tre White Defensive Rebound.",
"start_date": "2023-01-06T02:30:00Z",
"venue_name": "Pauley Pavilion",
"description": "USC vs UCLA",
"season_type": "Regular",
"season_week": null,
"season_year": "2023",
"away_starter": null,
"checked_date": "2023-01-06T02:55:51Z",
"current_outs": null,
"home_starter": null,
"weather_temp": null,
"away_team_abb": "USC",
"current_balls": null,
"home_team_abb": "UCLA",
"away_team_city": "USC",
"away_team_name": "Trojans",
"home_team_city": "UCLA",
"home_team_name": "Bruins",
"venue_location": "Los Angeles, CA",
"current_strikes": null,
"runner_on_first": null,
"runner_on_third": null,
"runner_on_second": null,
"weather_temp_high": null,
"current_possession": null,
"current_batter_name": null,
"score_away_period_1": 10,
"score_home_period_1": 18,
"current_pitcher_name": null,
"current_down_and_distance": null
},
{
"id": "6BC68D3A415B",
"sport": "Hockey",
"league": "NHL",
"start_date": "2022-02-13T17:30:00Z",
"season_type": "Regular",
"season_year": "2021-2022",
"season_week": "",
"away_team_abb": "BUF",
"away_team_city": "Buffalo",
"away_team_name": "Sabres",
"away_team": "Buffalo Sabres",
"home_team_abb": "MTL",
"home_team_city": "Montreal",
"home_team_name": "Canadiens",
"home_team": "Montreal Canadiens",
"description": "Buffalo Sabres vs Montreal Canadiens",
"venue_name": "Bell Centre",
"venue_location": "Montreal, QC",
"away_starting_goalie_name": "Craig Anderson",
"home_starting_goalie_name": "Sam Montembeault",
"is_live": false,
"status": "Completed",
"period": null,
"clock": null,
"score_away_total": 5,
"score_home_total": 3,
"score_away_period_1": 1,
"score_away_period_2": 2,
"score_away_period_3": 2,
"score_home_period_1": 0,
"score_home_period_2": 3,
"score_home_period_3": 0,
"checked_date": "2022-02-17T00:33:27Z",
"game_id": "10120-21758-2022-02-13"
},
{
"id": "646DAF876F18",
"sport": "Basketball",
"league": "NBA",
"start_date": "2022-02-13T19:00:00Z",
"season_type": "Regular",
"season_year": "2021-2022",
"season_week": "",
"away_team_abb": "ATL",
"away_team_city": "Atlanta",
"away_team_name": "Hawks",
"away_team": "Atlanta Hawks",
"home_team_abb": "BOS",
"home_team_city": "Boston",
"home_team_name": "Celtics",
"home_team": "Boston Celtics",
"description": "Atlanta Hawks vs Boston Celtics",
"venue_name": "TD Garden",
"venue_location": "Boston, MA",
"is_live": false,
"status": "Completed",
"period": null,
"clock": null,
"score_away_total": 95,
"score_home_total": 105,
"score_away_period_1": 28,
"score_away_period_2": 27,
"score_away_period_3": 23,
"score_away_period_4": 17,
"score_home_period_1": 17,
"score_home_period_2": 28,
"score_home_period_3": 42,
"score_home_period_4": 18,
"checked_date": "2022-02-17T00:33:26Z",
"game_id": "19957-77646-2022-02-13"
},
...
],
"page": 1,
"total_pages": 4
}