GoSportsAPIDocs
Sign InGet API Key
Football / Fixtures

Get Fixtures

Retrieve a list of fixtures — scheduled, live and finished — with detailed information.

GET/v1/football/fixtures

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
league_idintegerOptionalFilter by league ID.
seasonintegerOptionalFilter by season start year.
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<Fixture>
    Fixtures matching your filters.
  • idinteger
    Unique fixture ID.
  • leagueobject
    id, name and country.
  • seasoninteger
    Season start year.
  • datestring · ISO 8601
    Kick-off time in UTC.
  • statusobject
    short, long and live minute.
  • homeobject
    Home team: id, name, score.
  • awayobject
    Away team: id, name, score.
  • venueobject
    Stadium name and city.
  • metaobject
    page, per_page and total.

Status codes

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