--- title: "Retrieve box scores for specified match id." method: GET path: "/football/box-score/{matchId}" tags: ["Football.Match Box Score"] --- # Retrieve box scores for specified match id. `GET /football/box-score/{matchId}` ## Request - Base URL: `https://sports.highlightly.net` - URL: `https://sports.highlightly.net/football/box-score/{matchId}` - Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) > Refresh interval: Once every 5 minutes Retrieve detailed per-player box score match statistics data by specifying the `matchId` as the path parameter. The player box score statistics contain the general team information as well as a list of players and their respective stats. Each player has high level metadata information: | Data | Description | | --------------| --------------------------------------------------------------- | | id | Unique identifier for the player. | | Match rating | Match performance rating (e.g., "8.00"). | | Shirt number | Player's shirt/jersey number. | | Position | Playing position (e.g., "Goalkeeper", "Defender"). | | Is a captain | Indicates if the player was the team captain. | | Minutes played | Total minutes played in the match. | | Is a substitute | Indicates if the player started as a substitute. | | Offside | Number of offsides committed. | | Statistics | Detailed performance metrics. | | Name | Commonly known name of the player. | | Full name | Player's full registered name. | | Logo | URL to the player's image/logo, if available. | Besides the general metadata, each player has the following granular match performance statistics: | Statistic | Description | | -------------------- | ------------------------------------------------------------------ | | Goals scored | Number of goals the player scored in the match. | | Goals saved | Number of opponent shots saved (goalkeeper stat). | | Goals conceded | Goals allowed by the player's team while they were the goalkeeper. | | Assists | Passes that directly led to a goal. | | Total dribbles | Total dribble attempts made. | | Successful dribbles | Dribble attempts that successfully beat an opponent. | | Failed dribbles | Dribble attempts that were unsuccessful. | | Dribble success rate | Percentage of dribbles that were successful. | | Fouls received | Times the player was fouled by opponents. | | Fouls commited | Fouls committed by the player. | | Total tackles | Total tackles attempted. | | Total interceptions | Number of times the player intercepted an opponent's pass. | | Shots on target | Shots directed at goal that required a save or resulted in a goal. | | Shots off target | Shots that missed the goal completely. | | Shots total | Total shots attempted (on and off target). | | Shots accuracy | Percentage of shots that were on target. | | Penalties scored | Penalty kicks successfully converted into goals. | | Penalties missed | Penalty kicks that failed to score. | | Total penalties | Total penalty kicks taken. | | Penalty accuracy | Percentage of penalties scored. | | Passing accuracy | Percentage of completed passes. | | Successful passes | Passes that successfully reached a teammate. | | Failed passes | Passes that failed to reach a teammate. | | Total passes | Total passes attempted. | | Key passes | Passes that directly created a goal-scoring opportunity. | | Red cards | Number of red cards received. | | Yellow cards | Number of yellow cards received. | | Second yellow cards | Number of second yellow cards leading to a red card. | | Total duels | Number of 1v1 challenges contested. | | Won duels | Number of duels won. | | Lost duels | Number of duels lost. | | Duel success rate | Percentage of duels won. | | Expected assists (xA) | The estimated number of assists the player should have, based on chance quality. | | Expected goals (xG) | The estimated number of goals the player should have scored, based on chance quality. | | Expected goals on target (xGOT) | The expected number of goals based on the placement and quality of shots on target. | | Expected goals on target conceded (xGOT Conceded) | The expected number of goals a goalkeeper should have conceded based on shots faced. | | Expected goals prevented (xGP) | Difference between expected goals on target conceded and actual goals conceded (goalkeeper stat). | Below is an example of what you can aim to achieve with the player box score endpoint: ![Football player box score example](https://highlightly.net/assets/img/documentation/football/player-box-score.png) ## Path parameters - `matchId` number, required ## Headers - `x-rapidapi-host` string, required - `x-rapidapi-key` string, required ## Response `200` - FootballPlayerMatchStatisticsResponse[] - `team` FootballTeamBoxScoreResponseDto, required - `id` number, required - `logo` string, required - `name` string, required - `players` FootballPlayerBoxScore[], required - `id` number, required - `name` string, required - `fullName` string - `logo` string - `matchRating` string - `shirtNumber` number - `isCaptain` boolean, required - `position` 'Goalkeeper' | 'Defender' | 'Midfielder' | 'Forward' - `minutesPlayed` number, required - `isSubstitute` boolean, required - `offsides` number, required - `statistics` PlayerBoxScoreStatisticsDto[], required - `goalsScored` number, required - `goalsSaved` number, required - `goalsConceded` number, required - `assists` number, required - `dribblesTotal` number, required - `dribblesSuccessful` number, required - `dribblesFailed` number, required - `dribbleSuccessRate` string, required - `fouledByOthers` number, required - `fouledOthers` number, required - `tacklesTotal` number, required - `interceptionsTotal` number, required - `duelsTotal` number, required - `duelsWon` number, required - `duelsLost` number, required - `duelSuccessRate` string, required - `cardsRed` number, required - `cardsYellow` number, required - `cardsSecondYellow` number, required - `passesAccuracy` string, required - `passesSuccessful` number, required - `passesFailed` number, required - `passesTotal` number, required - `passesKey` number, required - `penaltiesScored` number, required - `penaltiesMissed` number, required - `penaltiesTotal` number, required - `penaltiesAccuracy` string, required - `shotsOnTarget` number, required - `shotsOffTarget` number, required - `shotsTotal` number, required - `shotsAccuracy` string, required - `expectedGoals` number - `expectedAssists` number - `expectedGoalsOnTarget` number - `expectedGoalsOnTargetConceded` number - `expectedGoalsPrevented` number ## 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)