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

Group: Players

One page of the player’s most recent fixtures, across every team they appeared for; since 2026-10-24 each page lists the newest first. Page 0 opens with any fixtures not yet started, soonest first (since 2026-10-27; earlier, a player with two matches ahead saw the later one first), then continues with the rest newest first. Every fixture includes playerMatch: the side the player was on, whether they remained on the bench, their rating, their match statistics (minutes in football; box scores in basketball and ice hockey) and their goals, assists and cards.

Plans: Every plan, Free included.

Note: A known player with no fixtures at the source gets 200 and an empty array. playerMatch.statistics shares its per-player keys with the lineups.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | DataSportsAPI player id, a positive integer |
| `page` | query | no | zero-based page number, a whole number from 0 to 50; the default 0 holds the most recent fixtures |

## Response

- `data`: `PlayerFixture[]`
- `meta`: page, count, hasNextPage
- Objects: PlayerFixture (https://datasportsapi.com/markdown/reference.md#playerfixture)

## Errors

- 400 bad_request — page is not a whole number between 0 and 50

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/players/{id}/fixtures"
```

TypeScript:

```ts
const { data, meta } = await client.players.fixtures(id);
for await (const page of client.players.fixturesPages(id)) { … }
```

Python:

```python
res = client.players.fixtures(id)
for page in client.players.fixtures_pages(id): ...
```

Go:

```go
res, err := client.Players.Fixtures(ctx, id, &datasportsapi.PlayersFixturesParams{})
for page, err := range client.Players.FixturesPages(ctx, id, &datasportsapi.PlayersFixturesParams{}) { … }
```

CLI:

```bash
$ dsa players fixtures <id>
$ dsa players fixtures <id> --all -o csv
```

## Example response

```json
{ "data": [ { "id": 201324, "status": { "type": "finished", … }, "home": { … }, "away": { … }, …,
      "playerMatch": { "side": "away", "onBench": false, "rating": 8.1, "statistics": { "minutesPlayed": 90 },
                       "incidents": { "goals": 1, "penaltyGoals": 1 } } }, … ],
  "meta": { "page": 0, "count": 30, "hasNextPage": true } }
```

---

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