GoSportsAPIDocs
Sign InGet API Key
Cricket / Matches

Get Matches

Retrieve Test, ODI and T20 matches — scheduled, live and finished — with venue, status and result.

GET/v1/cricket/matches

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
competition_idintegerOptionalFilter by competition ID.
formatstringOptionalTest, ODI, T20I or T20.
datedateOptionalFilter by date (YYYY-MM-DD, UTC).
team_idintegerOptionalFilter by team ID.
statusstringOptionalNS, LIVE, HT, FT, PST or CANC.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Match>
    Matches matching your filters.
  • idinteger
    Unique match ID.
  • competitionobject
    id and name.
  • formatstring
    Test, ODI, T20I or T20.
  • datestring · ISO 8601
    Start of play in UTC.
  • statusobject
    short and long.
  • homeobject
    Home team: id and name.
  • awayobject
    Away team: id and name.
  • venueobject
    Ground name and city.
  • resultstring | null
    Result summary once the match has finished.
  • metaobject
    page, per_page and total.

Status codes

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