Get soccer match by ID

Returns a single soccer match by its match ID, or by its static_id. The detail adds timeline: the events normalised (minute, extra_minute, team home/away, team_id, kind goal, penalty, own_goal, missed_penalty, yellow, second_yellow, red, substitution or var, player, assist, player_in/player_out, detail: card reason, "injury" or the VAR outcome, on_field_decision) from the commentary summary (top leagues) or else the livescore events (minute null when the feed gave none; no header, body part or per-shot xG: not in the feeds); and referee_stats: the referee's season in this league (see /soccer/referees).

Parameters

• idinteger · pathrequired

  Match ID

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

• dataobject
• added_timeobject

  commentaries feed (top leagues)

• first_halfinteger
• second_halfinteger
• attendanceinteger

  commentaries feed (top leagues) or an official source

• away_teamobject
• idinteger
• namestring
• scoreinteger
• eventsarray of object
• extra_time_scorestring
• fixture_idinteger

  season fixtures feed id

• full_time_scorestring

  90 minutes

• half_time_scorestring
• highlightsstring

  Highlights video (YouTube) once posted, and the TV channels showing the match, by country (TheSportsDB). Every sport's match answers carry them (middleware.MatchMedia); listed here for the API docs.

• home_teamobject
• idinteger
• namestring
• scoreinteger
• idinteger
• league_gidinteger
• league_idinteger
• league_namestring
• match_idinteger
• penalty_scorestring

  shoot-out

• refereestring

  commentaries feed (top leagues) or an official source

• referee_statsobject

  RefereeStats: the referee's season in this league (match detail only; absent without a referee or computed statistics).

• countrystring
• first_match_datestring
• gamesinteger
• last_match_datestring
• league_idinteger
• league_matches_playedinteger
• league_matches_with_refereeinteger
• league_matches_with_statsinteger
• league_namestring
• namestring
• penaltiesinteger
• penalties_per_gamenumber
• red_cardsinteger
• red_per_gamenumber
• seasonstring
• second_yellowsinteger
• slugstring
• updated_atstring
• yellow_cardsinteger
• yellow_per_gamenumber
• roundstring
• seasonstring
• sourcesobject

  Sources names the official source of fields it supplied (e.g. {"result": "dfb", "events": "dfb"}); absent when all data is the provider's.

• sportstring
• start_datestring
• start_timestring
• static_idinteger

  the data provider id shared by livescore and season feeds; the stable key

• statusstring
• timelinearray of object

  Timeline: the events normalised (kind goal, penalty, own_goal, missed_penalty, yellow, second_yellow, red, substitution, var), from the commentary summary (top leagues) or else the events above. Match detail only; absent when no event is known.

• assistobject
• detailstring

  Detail: a card's reason, "injury" for an injury substitution, a VAR review's outcome ("Goal cancelled").

• extra_minuteinteger
• kindstring
• minuteinteger

  null: the feed gave no minute

• on_field_decisionstring

  VAR: the referee's decision reviewed

• playerobject
• player_inobject
• player_outobject
• teamstring

  home or away

• team_idinteger
• tvarray of object
• channelstring
• countrystring

Errors

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON