> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Football Stats Catalogue

> Every stat key the Football V2 API returns for matches, lineups, player seasons and team seasons

This page lists every stat key recorded from real responses on 24 September 2026 (Bundesliga, season `97464`, match `16434052`). Coverage is deepest for top leagues; lower tiers may return a subset. Full example payloads are on the [Match](/api-reference/football-v2/match#example-responses), [Team](/api-reference/football-v2/team#example-responses), [Player](/api-reference/football-v2/player#example-responses) and [Tournament](/api-reference/football-v2/tournament#example-responses) pages.

## Match statistics

`GET /match/{matchId}/statistics` returns periods (`ALL`, `1ST`, `2ND`), each with these groups. Every item carries `home`, `away`, `homeValue`, `awayValue` and `compareCode`.

| Group          | Keys                                                                                                                                                                                                                           |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Match overview | `ballPossession`, `kilometersCovered`, `expectedGoals`, `bigChanceCreated`, `totalShotsOnGoal`, `goalkeeperSaves`, `numberOfSprints`, `cornerKicks`, `fouls`, `passes`, `totalTackle`, `freeKicks`, `yellowCards`, `avgRating` |
| Shots          | `totalShotsOnGoal`, `shotsOnGoal`, `expectedGoals`, `expectedGoalsOnTarget`, `hitWoodwork`, `shotsOffGoal`, `blockedScoringAttempt`, `totalShotsInsideBox`, `totalShotsOutsideBox`                                             |
| Attack         | `bigChanceScored`, `bigChanceMissed`, `accurateThroughBall`, `touchesInOppBox`, `fouledFinalThird`, `offsides`                                                                                                                 |
| Passes         | `accuratePasses`, `throwIns`, `finalThirdEntries`, `finalThirdPhaseStatistic`, `accurateLongBalls`, `accurateCross`                                                                                                            |
| Duels          | `duelWonPercent`, `dispossessed`, `groundDuelsPercentage`, `aerialDuelsPercentage`, `dribblesPercentage`                                                                                                                       |
| Defending      | `wonTacklePercent`, `totalTackle`, `interceptionWon`, `ballRecovery`, `totalClearance`                                                                                                                                         |
| Goalkeeping    | `goalkeeperSaves`, `goalsPrevented`, `diveSaves`, `highClaims`, `punches`, `goalKicks`                                                                                                                                         |

## Player match statistics (lineups)

`GET /match/{matchId}/lineups` returns a `statistics` object per player, including a match `rating`:

`totalPass`, `accuratePass`, `totalLongBalls`, `accurateLongBalls`, `goalAssist`, `accurateOwnHalfPasses`, `totalOwnHalfPasses`, `accurateOppositionHalfPasses`, `totalOppositionHalfPasses`, `duelWon`, `totalClearance`, `ballRecovery`, `wasFouled`, `savedShotsFromInsideTheBox`, `saves`, `punches`, `totalKeeperSweeper`, `accurateKeeperSweeper`, `minutesPlayed`, `touches`, `rating`, `possessionLostCtrl`, `expectedAssists`, `totalBallCarriesDistance`, `ballCarriesCount`, `totalProgression`, `progressiveBallCarriesCount`, `keeperSaveValue`, `ratingVersions`, `totalShots`, `goalsPrevented`, `passValueNormalized`, `dribbleValueNormalized`, `defensiveValueNormalized`, `goalkeeperValueNormalized`, `statisticsType`

Per-player match stats are also available from `GET /match/{matchId}/player/{playerId}/statistics`, along with shotmaps and heatmaps.

## Player season statistics

`GET /players/{playerId}/tournament/{tournamentId}/season/{seasonId}/statistics?type=overall`:

`rating`, `totalRating`, `countRating`, `goals`, `bigChancesCreated`, `bigChancesMissed`, `assists`, `expectedAssists`, `goalsAssistsSum`, `expectedGoalsInvolvement`, `accuratePasses`, `inaccuratePasses`, `totalPasses`, `accuratePassesPercentage`, `accurateOwnHalfPasses`, `accurateOppositionHalfPasses`, `accurateFinalThirdPasses`, `keyPasses`, `successfulDribbles`, `successfulDribblesPercentage`, `tackles`, `interceptions`, `yellowCards`, `directRedCards`, `redCards`, `accurateCrosses`, `accurateCrossesPercentage`, `totalShots`, `shotsOnTarget`, `shotsOffTarget`, `groundDuelsWon`, `groundDuelsWonPercentage`, `aerialDuelsWon`, `aerialDuelsWonPercentage`, `totalDuelsWon`, `totalDuelsWonPercentage`, `minutesPlayed`, `goalConversionPercentage`, `penaltiesTaken`, `penaltyGoals`, `penaltyWon`, `penaltyConceded`, `shotFromSetPiece`, `freeKickGoal`, `goalsFromInsideTheBox`, `goalsFromOutsideTheBox`, `shotsFromInsideTheBox`, `shotsFromOutsideTheBox`, `headedGoals`, `leftFootGoals`, `rightFootGoals`, `accurateLongBalls`, `accurateLongBallsPercentage`, `clearances`, `errorLeadToGoal`, `errorLeadToShot`, `dispossessed`, `possessionLost`, `possessionWonAttThird`, `totalChippedPasses`, `accurateChippedPasses`, `touches`, `wasFouled`, `fouls`, `hitWoodwork`, `ownGoals`, `dribbledPast`, `offsides`, `blockedShots`, `passToAssist`, `saves`, `kilometersCovered`, `numberOfSprints`, `topSpeed`, `cleanSheet`, `penaltyFaced`, `penaltySave`, `savedShotsFromInsideTheBox`, `savedShotsFromOutsideTheBox`, `goalsConcededInsideTheBox`, `goalsConcededOutsideTheBox`, `punches`, `runsOut`, `successfulRunsOut`, `highClaims`, `crossesNotClaimed`, `matchesStarted`, `penaltyConversion`, `setPieceConversion`, `totalAttemptAssist`, `totalContest`, `totalCross`, `duelLost`, `aerialLost`, `attemptPenaltyMiss`, `attemptPenaltyPost`, `attemptPenaltyTarget`, `totalLongBalls`, `goalsConceded`, `tacklesWon`, `tacklesWonPercentage`, `scoringFrequency`, `yellowRedCards`, `savesCaught`, `savesParried`, `totalOwnHalfPasses`, `totalOppositionHalfPasses`, `totwAppearances`, `expectedGoals`, `goalKicks`, `ballRecovery`, `outfielderBlocks`, `kilometersCoveredPer90`, `numberOfSprintsPer90`, `appearances`, `statisticsType`

## Team season statistics

`GET /teams/{teamId}/tournament/{tournamentId}/season/{seasonId}/statistics?type=overall`. Keys ending in `Against` are what opponents recorded against the team:

`goalsScored`, `goalsConceded`, `ownGoals`, `assists`, `shots`, `penaltyGoals`, `penaltiesTaken`, `freeKickGoals`, `freeKickShots`, `goalsFromInsideTheBox`, `goalsFromOutsideTheBox`, `shotsFromInsideTheBox`, `shotsFromOutsideTheBox`, `headedGoals`, `leftFootGoals`, `rightFootGoals`, `bigChances`, `bigChancesCreated`, `bigChancesMissed`, `shotsOnTarget`, `shotsOffTarget`, `blockedScoringAttempt`, `successfulDribbles`, `dribbleAttempts`, `corners`, `hitWoodwork`, `fastBreaks`, `fastBreakGoals`, `fastBreakShots`, `averageBallPossession`, `totalPasses`, `accuratePasses`, `accuratePassesPercentage`, `totalOwnHalfPasses`, `accurateOwnHalfPasses`, `accurateOwnHalfPassesPercentage`, `totalOppositionHalfPasses`, `accurateOppositionHalfPasses`, `accurateOppositionHalfPassesPercentage`, `totalLongBalls`, `accurateLongBalls`, `accurateLongBallsPercentage`, `totalCrosses`, `accurateCrosses`, `accurateCrossesPercentage`, `cleanSheets`, `tackles`, `interceptions`, `saves`, `errorsLeadingToGoal`, `errorsLeadingToShot`, `penaltiesCommited`, `penaltyGoalsConceded`, `clearances`, `clearancesOffLine`, `lastManTackles`, `totalDuels`, `duelsWon`, `duelsWonPercentage`, `totalGroundDuels`, `groundDuelsWon`, `groundDuelsWonPercentage`, `totalAerialDuels`, `aerialDuelsWon`, `aerialDuelsWonPercentage`, `possessionLost`, `offsides`, `fouls`, `yellowCards`, `yellowRedCards`, `redCards`, `avgRating`, `avgRatingVersion`, `accurateFinalThirdPassesAgainst`, `accurateOppositionHalfPassesAgainst`, `accurateOwnHalfPassesAgainst`, `accuratePassesAgainst`, `bigChancesAgainst`, `bigChancesCreatedAgainst`, `bigChancesMissedAgainst`, `clearancesAgainst`, `cornersAgainst`, `crossesSuccessfulAgainst`, `crossesTotalAgainst`, `dribbleAttemptsTotalAgainst`, `dribbleAttemptsWonAgainst`, `errorsLeadingToGoalAgainst`, `errorsLeadingToShotAgainst`, `hitWoodworkAgainst`, `interceptionsAgainst`, `keyPassesAgainst`, `longBallsSuccessfulAgainst`, `longBallsTotalAgainst`, `offsidesAgainst`, `redCardsAgainst`, `shotsAgainst`, `shotsBlockedAgainst`, `shotsFromInsideTheBoxAgainst`, `shotsFromOutsideTheBoxAgainst`, `shotsOffTargetAgainst`, `shotsOnTargetAgainst`, `blockedScoringAttemptAgainst`, `tacklesAgainst`, `totalFinalThirdPassesAgainst`, `oppositionHalfPassesTotalAgainst`, `ownHalfPassesTotalAgainst`, `totalPassesAgainst`, `yellowCardsAgainst`, `throwIns`, `goalKicks`, `ballRecovery`, `freeKicks`, `kilometersCovered`, `numberOfSprints`, `expectedGoals`, `expectedGoalsOnTarget`, `expectedAssists`, `goalsPrevented`, `touches`, `keyPasses`, `defensiveContributions`, `matches`, `awardedMatches`, `statisticsType`

## Also available

* Shotmap with per-shot xG, body part, situation and coordinates: `/match/{matchId}/shotmap`
* Momentum graph by minute: `/match/{matchId}/graph`
* Season leaderboards: `/tournament/{tournamentId}/season/{seasonId}/top-players` and `/top-teams`
* Standings (total, home, away), rounds, H2H, recent form, odds and WebSocket live updates