> ## 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.

# What Data You Get

> A tour of real Football V2 responses for one top-league match: statistics, incidents, lineups, shotmap, momentum and standings

Every example on this page and on the linked reference pages is a real response, recorded on 24 September 2026 from Bundesliga match `16434052` (season `97464`). Lists are trimmed to two items. Top leagues return the full set shown here; lower tiers may return a subset. For every stat key, see the [Stats Catalogue](https://docs.sportsapipro.com/api-reference/football-v2/stats-catalogue.md).

## At a glance

| Data | Endpoint | What it contains |
| - | - | - |
| Match details | `GET /match/{matchId}` | Teams, score with period splits, status, venue, referee, round, start time |
| Statistics | `GET /match/{matchId}/statistics` | 40+ team metrics per period (`ALL`, `1ST`, `2ND`): possession, xG, shots, passes, duels, corners, distance covered, sprints |
| Incidents | `GET /match/{matchId}/incidents` | Goals (scorer, assist, minute), cards, substitutions, VAR decisions, period and injury-time markers |
| Lineups | `GET /match/{matchId}/lineups` | Formations, starters and bench, jersey numbers, per-player match statistics and ratings |
| Shotmap | `GET /match/{matchId}/shotmap` | Every shot with minute, player, body part, situation (open play, corner, set piece), pitch and goal-mouth coordinates, xG |
| Momentum | `GET /match/{matchId}/graph` | Attacking pressure minute by minute |
| Average positions | `GET /match/{matchId}/average-positions` | Average x/y position per player |
| Best players | `GET /match/{matchId}/best-players` | Top-rated players for each side |
| Commentary | `GET /match/{matchId}/comments` | Minute-by-minute text commentary |
| Standings | `GET /tournament/{tournamentId}/season/{seasonId}/standings` | Table with played, wins, draws, losses, goals, points, form |
| Season fixtures | `GET /tournament/{tournamentId}/season/{seasonId}/events/last/{page}` | 30 finished matches per page with full scores |
| Player season | `GET /players/{playerId}/statistics` | Season totals and per-90 figures, rating, xG, xA |

## Example: match statistics

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/match/16434052/statistics"
```

```json theme={null}
{
  "success": true,
  "matchId": 16434052,
  "endpoint": "statistics",
  "data": {
    "statistics": [
      {
        "period": "ALL",
        "groups": [
          {
            "groupName": "Match overview",
            "statisticsItems": [
              { "name": "Ball possession", "home": "34%", "away": "66%", "homeValue": 34, "awayValue": 66, "key": "ballPossession" },
              { "name": "Distance covered", "home": "114.0 km", "away": "115.3 km", "homeValue": 113.97, "awayValue": 115.28, "key": "kilometersCovered" }
            ]
          },
          {
            "groupName": "Shots",
            "statisticsItems": [
              { "name": "Total shots", "home": "13", "away": "23", "homeValue": 13, "awayValue": 23, "key": "totalShotsOnGoal" },
              { "name": "Shots on target", "home": "5", "away": "2", "homeValue": 5, "awayValue": 2, "key": "shotsOnGoal" }
            ]
          }
        ]
      }
    ]
  }
}
```

## Full examples for every endpoint

* [Match](https://docs.sportsapipro.com/api-reference/football-v2/match.md): details, lineups, statistics, incidents, shotmap, momentum, average positions, best players, odds, commentary
* [Tournament](https://docs.sportsapipro.com/api-reference/football-v2/tournament.md): standings, fixtures, top players, rounds
* [Team](https://docs.sportsapipro.com/api-reference/football-v2/team.md): squad, season statistics, transfers
* [Player](https://docs.sportsapipro.com/api-reference/football-v2/player.md): profile, season statistics, characteristics, transfer history
* [Global](https://docs.sportsapipro.com/api-reference/football-v2/global.md): live, today, schedule, search

Every interactive reference page also shows a recorded response next to the request.

> [!NOTE]
>
> The Free plan (100 requests a day, no card) is enough to call each of these endpoints yourself.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.