GoSportsAPIDocs
Sign InGet API Key
Baseball / Livescores

Get Live Scores

Retrieve every game in progress right now, with runs, inning, outs and base state.

GET/v1/baseball/livescores

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
league_idintegerOptionalFilter by league ID.
team_idintegerOptionalFilter by team ID.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Game>
    Games currently in progress.
  • idinteger
    Unique game ID.
  • leagueobject
    id and name.
  • seasoninteger
    Season year.
  • datestring · ISO 8601
    First pitch in UTC.
  • statusobject
    short, inning, half and outs.
  • homeobject
    Home team: id, name, runs.
  • awayobject
    Away team: id, name, runs.
  • venueobject
    Ballpark name and city.
  • basesobject
    Whether first, second and third are occupied.
  • metaobject
    page, per_page and total.

Status codes

  • 200Live games returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached