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

Group: Fixtures

AI-written commentary on a football fixture, oldest first by seq (newest 100): a short entry per goal, missed penalty, red card, VAR decision, period start or end, big chance and sustained swing in momentum. Events seconds apart are merged into one entry, and there are summaries at half-time and full time. Available on Pro, Business and Enterprise plans.

Plans: Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.

Note: DataSportsAPI AI writes every line from our own match data alone (score, clock, events, statistics, shot map and our win-probability model) and stays clear of betting language. Entries are generated only while the match is being followed, either through this endpoint or through a fixture:{id} WebSocket channel, so request it while the game is on; a match that nobody followed has no entries. Featured top-league matches on datasportsapi.com always get commentary. Every entry is written a single time and served identically to all clients, and its seq is permanent. kind takes one of these values: kickoff, goal, redCard, missedPenalty, varDecision, bigChance, momentum, periodStart, periodEnd, halfTime, fullTime, update. The minute of a fullTime summary is 90 (120 after extra time). On Business and Enterprise, fixture:{id} channels receive a commentary frame for each new entry.

## Parameters

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

## Response

- `data`: `Commentary`
- `meta`: count, generatedBy
- Objects: Commentary (https://datasportsapi.com/markdown/reference.md#commentary)

## Errors

- 403 endpoint_not_in_plan — returned to keys on the Free and Starter plans
- 404 not_supported — the fixture is not a football match

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}/commentary"
```

TypeScript:

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

Python:

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

Go:

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

CLI:

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

## Example response

```json
{ "data": { "fixtureId": 236923, "entries": [ …,
      { "seq": 2, "kind": "goal", "minute": 36, "addedMinute": null, "model": "datasportsapi-ai", "createdAt": "2026-10-18T13:37:41.000Z",
        "text": "Nico Paz doubles Como's lead, finishing after a pass from Álex Valle, four minutes after Mattia Liberali's opener. Our model now gives Como an 85% win probability, up from 65%." },
      { "seq": 3, "kind": "halfTime", "minute": 45, "addedMinute": null, "model": "datasportsapi-ai", "createdAt": "2026-10-18T13:52:04.000Z",
        "text": "Como lead Fiorentina 2-1 at the break. Mattia Liberali and Nico Paz struck in the 32nd and 36th minutes before Marin Pongračić pulled one back, a goal confirmed by VAR in first-half stoppage time." } ] },
  "meta": { "count": 3, "generatedBy": "datasportsapi-ai" } }
```

---

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/commentary/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
