---
title: "Get live events by match id"
method: GET
path: "/football/events/{id}"
tags: ["Football.Live Events"]
---

# Get live events by match id

`GET /football/events/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/football/events/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/football/events/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

> 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:

| Type        | Description |
| -----------  | ----------- |
| Goal         | A player strikes the ball into the opposing team's goal.        |
| Own Goal         | A player strikes or deflects the ball into their own team's goal.             |
| Penalty         | A player scores the goal from the penalty spot after a foul or hand play by the defending team inside the penalty area.    |
| Missed Penalty         | The player taking the penalty kick failed to score, either by missing the target or the shot being saved by the goalkeeper.             |
| Yellow Card         | A player is cautioned by the referee for unsporting behavior or foul play.            |
| Red Card         | A player is sent off the field for serious foul play, violent conduct, or receiving a second yellow card.            |
| Substitution         | A player is replaced by another player from the bench during a stoppage in play.   |
| VAR Goal Confirmed         | The Video Assistant Referee (VAR) review confirms that a goal is valid and should stand.            |
| VAR Goal Cancelled         | The VAR review determines that a goal should be disallowed due to an infringement or violation.            |
| VAR Penalty         | The VAR review results in a penalty being awarded to a team.      |
| VAR Penalty Cancelled         | The VAR review results in a previously awarded penalty being overturned.   |
| VAR Goal Cancelled - Offside         | The 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](https://highlightly.net/assets/img/documentation/football/live-events.png)

## Path parameters

- `id` number, required

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- FootballLiveEventDto[]
  - `team` FootballLiveEventTeamDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `time` string, 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
  - `playerId` number
  - `player` string
  - `assistingPlayerId` number
  - `assist` string
  - `substituted` string

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)