GoSportsAPIDocs
Sign InGet API Key
Cricket / Livescores

Get Live Scores

Retrieve every match in progress right now, with runs, wickets and overs for each side and the target when chasing.

GET/v1/cricket/livescores

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
competition_idintegerOptionalFilter by competition ID.
formatstringOptionalTest, ODI, T20I or T20.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Match>
    Matches currently in progress.
  • idinteger
    Unique match ID.
  • formatstring
    Test, ODI, T20I or T20.
  • statusobject
    short and current innings.
  • homeobject
    id, name, runs, wickets and overs.
  • awayobject
    id, name, runs, wickets and overs.
  • battingstring
    home or away.
  • targetinteger | null
    Runs needed to win, when chasing.
  • metaobject
    page, per_page and total.

Status codes

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