HIhighlightly
Football.Live Events

Get live events by match id

Refresh interval: Once a minute

Retrieve a list of live events for a match by specifying matchId as the path parameter.

Currently supported live events:

TypeDescription
GoalA player strikes the ball into the opposing team's goal.
Own GoalA player strikes or deflects the ball into their own team's goal.
PenaltyA player scores the goal from the penalty spot after a foul or hand play by the defending team inside the penalty area.
Missed PenaltyThe player taking the penalty kick failed to score, either by missing the target or the shot being saved by the goalkeeper.
Yellow CardA player is cautioned by the referee for unsporting behavior or foul play.
Red CardA player is sent off the field for serious foul play, violent conduct, or receiving a second yellow card.
SubstitutionA player is replaced by another player from the bench during a stoppage in play.
VAR Goal ConfirmedThe Video Assistant Referee (VAR) review confirms that a goal is valid and should stand.
VAR Goal CancelledThe VAR review determines that a goal should be disallowed due to an infringement or violation.
VAR PenaltyThe VAR review results in a penalty being awarded to a team.
VAR Penalty CancelledThe VAR review results in a previously awarded penalty being overturned.
VAR Goal Cancelled - OffsideThe VAR review determines that a goal should be disallowed due to an offside infringement.

The above list may be updated with additional entries in the future.

Below is an example of what you can aim to achieve with the live events endpoint:

Football live events example

get/football/events/{id}

Request

Path parameters

idnumber required

Requested match id.

Headers

x-rapidapi-hoststring required

sport-highlights-api.p.rapidapi.com

x-rapidapi-keystring required

Rapid API Token

Response

timestring required
type'Goal' | 'Own Goal' | 'Penalty' | 'Missed Penalty' | 'Yellow Card' | 'Red Card' | 'Substitution' | 'VAR Goal Confirmed' | 'VAR Goal Cancelled' | 'VAR Penalty' | 'VAR Penalty Cancelled' | 'VAR Goal Cancelled - Offside' required
playerIdnumber
playerstring
assistingPlayerIdnumber
assiststring
substitutedstring

Example response

[
  {
    "team": {
      "id": 13394673,
      "logo": "https://example.com/logo/preview/66311.13394673",
      "name": "Tersana"
    },
    "time": "45+1",
    "type": "Goal",
    "playerId": 63606907,
    "player": "M. Mamdouh",
    "assist": "J. Johanson"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.