--- title: "Get match by id" method: GET path: "/football/matches/{id}" tags: ["Football.Matches"] --- # Get match by id `GET /football/matches/{id}` ## Request - Base URL: `https://sports.highlightly.net` - URL: `https://sports.highlightly.net/football/matches/{id}` - Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve detailed match information by specifying the match id path parameter. Certain popular leagues and their associated matches will have additional data about the `venue`, weather `forecast`, match `statistics`, match `news` and who the game's `referee` is. The retrieved data will also contain a list of important events that happened: | 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. > Note: Used to retrieve additional match information. ## Path parameters - `id` number, required ## Headers - `x-rapidapi-host` string, required - `x-rapidapi-key` string, required ## Response `200` - FootballDetailedMatchResponseDto[] - `id` number, required - `round` string, required - `date` string, required - `country` FootballCountryResponseDto, required - `code` string, required: Country code specified by the ISO 3166 standard. - `name` string, required - `logo` string, required - `awayTeam` FootballDetailedTeamResponseDto, required - `id` number, required - `logo` string - `name` string, required - `shots` FootballShotsDto[] - `playerName` string, required - `time` string, required - `outcome` string, required - `goalTarget` string, required - `topPlayers` FootballTopPlayersResponse[] - `position` string, required - `name` string, required - `statistics` FootballTopPlayerStatisticsResponse[], required - `name` string, required - `value` object, required - `homeTeam` FootballDetailedTeamResponseDto, required - `id` number, required - `logo` string - `name` string, required - `shots` FootballShotsDto[] - `playerName` string, required - `time` string, required - `outcome` string, required - `goalTarget` string, required - `topPlayers` FootballTopPlayersResponse[] - `position` string, required - `name` string, required - `statistics` FootballTopPlayerStatisticsResponse[], required - `name` string, required - `value` object, required - `league` FootballMatchLeagueResponseDto, required - `id` number, required - `season` number, required - `name` string, required - `logo` string - `state` FootballMatchStateResponseDto, required - `description` 'To be announced' | 'Not started' | 'First half' | 'Half time' | 'Second half' | 'Extra time' | 'Break time' | 'Penalties' | 'Suspended' | 'Interrupted' | 'Finished' | 'Finished after penalties' | 'Finished after extra time' | 'Postponed' | 'Cancelled' | 'Abandoned' | 'Awarded' | 'In progress' | 'Unknown', required: State of the match. - `clock` number: Current minute of the match. - `score` FootballMatchScoreResponseDto, required - `current` string: Home - Away score up to penalties. - `penalties` string: Home - Away team score after the penalties phase. - `events` FootballLiveEventDto[], required - `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 - `statistics` FootballMatchStatisticsResponseDto[], required - `team` FootballTeamResponseDto, required - `id` number, required - `logo` string - `name` string, required - `statistics` FootballMatchStatisticsResponseItemDto[], required - `value` number, required - `displayName` string, required - `referee` DetailedMatchRefereeResponseDto - `name` string - `nationality` string - `venue` DetailedMatchVenueResponseDto - `city` string - `name` string - `country` string - `capacity` string - `forecast` DetailedMatchForecastResponseDto - `status` string - `temperature` string - `predictions` PredictionResponseDto - `prematch` PredictionDto[], required - `type` string, required - `modelType` string, required - `generatedAt` string, required - `description` string, required - `probabilities` PredictionProbabilitiesDto, required - `home` string, required - `draw` string - `away` string, required - `live` PredictionDto[], required - `type` string, required - `modelType` string, required - `generatedAt` string, required - `description` string, required - `probabilities` PredictionProbabilitiesDto, required - `home` string, required - `draw` string - `away` string, required - `news` NewsDto[] - `url` string, required - `image` string, required - `title` string, required - `datePublished` string, required ## 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)