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

Group: Fixtures

The player of the match together with the top-rated players on each team.

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

Note: Filled once ratings exist, which in covered leagues means during or after the match. Until then the answer is 200, with playerOfTheMatch set to null and the lists empty. label tells you what value is: a rating in football, points in basketball and ice hockey, goals in handball, yards in American football. In basketball there is one player per side, with statistics holding their line (points, rebounds, assists, steals, blocks, rating). In baseball (since 2026-11-04) the list holds the players the source rates best, each placed with their team, with role (pitcher or batter) and the stat line, pitching or batting, behind the choice; value and label are null because the source does not document its figure for them, and the ordering is the source’s, best first. Other sports have statistics set to null, and role is null in every sport except baseball.

## Parameters

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

## Response

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

## 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}/best-players"
```

TypeScript:

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

Python:

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

Go:

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

CLI:

```bash
$ dsa fixtures best-players <id>
```

## Example response

```json
{ "data": { "playerOfTheMatch": { "player": { "id": 4120, "name": "Gabriel Magalhães", … }, "value": 8.0, "label": "rating" },
    "home": [ { "player": { "id": 4188, "name": "Liam Delap", … }, "value": 7.5, "label": "rating" }, … ],
    "away": [ … ] } }

// Basketball:
{ "data": { "playerOfTheMatch": null,
    "home": [ { "player": { "id": 817, "name": "Trae Young", … }, "value": 31, "label": "points",
                "statistics": { "points": 31, "rebounds": 4, "assists": 11, "steals": 2, "blocks": 0, "rating": 8.9 }, "role": null } ],
    "away": [ … ] } }

// Baseball:
{ "data": { "playerOfTheMatch": null, "home": [],
    "away": [ { "player": { "id": 912, "name": "Yandy Díaz", … }, "value": null, "label": null, "role": "batter",
                "statistics": { "battingHits": 2, "battingAtBats": 5, "battingHomeRuns": 1, "battingRbi": 2, "battingRuns": 2 } },
              { "player": { "name": "Nick Martinez", … }, "value": null, "label": null, "role": "pitcher",
                "statistics": { "pitchingInningsPitched": 5.1, "pitchingWins": 1, "pitchingHitsAllowed": 2 } }, … ] } }
```

---

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