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

# Match Stats & Lineups

> Team stats with 20+ metrics, full match statistics, and player lineups

## Team Stats (Live)

```text theme={null}
GET /api/v1/match/{matchId}/team-stats
```

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn/team-stats"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn/team-stats"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "success": true,
  "matchStats": {
    "0": {
      "stats": {
        "101": { "values": ["1", "0"] },
        "102": { "values": ["1", "9"] },
        "121": { "values": ["3", "6"] },
        "122": { "values": ["1", "8"] },
        "123": { "values": ["54", "144"] },
        "124": { "values": ["28", "103"] },
        "125": { "values": ["59", "41"] },
        "128": { "values": ["4", "14"] }
      }
    }
  }
}
```

* `matchStats` keys are periods: `"0"` = full match, `"1"` = 1st half, `"2"` = 2nd half.
* Each `values` array is `[home, away]` as strings.

### Stat ID Reference

| ID  | Meaning      | ID  | Meaning               |
| --- | ------------ | --- | --------------------- |
| 101 | Goals        | 121 | Shots                 |
| 102 | Corners      | 122 | Attacks               |
| 103 | Red Cards    | 123 | Possession (%)        |
| 104 | Yellow Cards | 124 | Dangerous Attacks     |
| 105 | Free Kicks   | 125 | Shots on Target (%)   |
| 106 | Goal Kicks   | 127 | Blocked Shots         |
| 107 | Throw-ins    | 128 | Shots on Target       |
| 108 | Offsides     | 132 | Saves                 |
| 109 | Fouls        | 137 | Tackles               |
| 113 | Penalties    | 183 | Total Shots on Target |
| 114 | Own Goals    |     |                       |

**Cache TTL:** 5 s (live data).

## Match Statistics (Generic)

```text theme={null}
GET /api/v1/match/{matchId}/stats
```

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

## Lineups

```text theme={null}
GET /api/v1/match/{matchId}/lineups
```

Returns player lineups when available (major leagues / tournaments).

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

**Cache TTL:** 60 s.

<Note>
  Basketball matches do not expose `/stats`, `/team-stats`, `/lineups`, `/incidents`, `/commentary`, or `/tables` — only `/match/{id}`, `/odds`, `/odds/{companyId}`, and `/h2h?sport_id=2`.
</Note>