# GET /v2/fixtures/{id}/statistics

Group: Fixtures

Team statistics for the match, organised by period and by category.

Plans: Every plan, Free included.

Note: Coverage is graded the same way as for lineups and grows richer as the match goes on: a lower-tier fixture might offer nothing but cards, whereas a top league delivers every group. Statistic keys form one shared vocabulary across all sports (totalShots, shotsOnGoal, passes, fouls, …; the reference’s Statistic keys lists every key per sport), and group keys follow a fixed table for each sport. In American football, the team-level passingNetYards and passingYardsPerAttempt are gross figures from the source (sacks are not subtracted), whereas a player’s passingNetYards in the lineups is net. A fixture without statistics (yet — before kick-off, for instance) returns 200 with { "periods": [] }; you only get 404 for an id that does not exist. Data is refreshed approximately every 30 seconds during a live match.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | fixture id issued by DataSportsAPI, a positive integer |

## Response

- `data`: `Statistics`
- Objects: Statistics (https://datasportsapi.com/markdown/reference.md#statistics)

## Errors

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/statistics"
```

TypeScript:

```ts
const { data, meta } = await client.fixtures.statistics(id);
```

Python:

```python
res = client.fixtures.statistics(id)
```

Go:

```go
res, err := client.Fixtures.Statistics(ctx, id)
```

CLI:

```bash
$ dsa fixtures statistics <id>
```

## Example response

```json
{ "data": { "periods": [ { "period": "all", "groups": [
    { "key": "matchOverview", "name": "Match overview", "items": [
      { "key": "ballPossession", "name": "Ball possession", "kind": "value", "higherIs": "better",
        "home": { "display": "26%", "value": 26, "total": null }, "away": { "display": "74%", "value": 74, "total": null } },
      { "key": "fouls", "name": "Fouls", "kind": "value", "higherIs": "worse",
        "home": { "display": "13", "value": 13, "total": null }, "away": { "display": "11", "value": 11, "total": null } },
      { "key": "accurateLongBalls", "name": "Long balls", "kind": "ratio", "higherIs": "better",
        "home": { "display": "30/64 (47%)", "value": 30, "total": 64 }, "away": { … } }, … ] } ] },
    { "period": "period1", "groups": [ … ] } ] } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/fixtures/statistics/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
