Skip to main content
Version: 2.0.0

Live Game Scores API Documentation

Description

This endpoint returns all the games scores for live, completed and unplayed games, filterable by sports, league, & more.

REQUIREMENT

You'll need a license key to use OpticOdds' API. You can get one by contacting us at www.opticodds.com.

API Endpoint

https://api.opticodds.com/api/v2/scores

Supported Leagues

NBA, NFL, NHL, MLB, NCAAB, NCAAF, UFC, ATP, WTA, Soccer, AFL, UFL, KBO, NPB, NCAA Baseball, NCAA Lacrosse

Parameters

key (required)

Your OpticOdds 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
  • lacrosse
  • cricket
  • volleyball

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 OpticOdds game ID you want to receive scores for (e.g. 39341-78014-2022-01-17)

live

Whether you want live scores or completed.

status

Filter games by status, possible statuses are Live|Half|Unplayed|Completed|Cancelled|Suspended|Delayed.

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
}