# GET /v2/teams/{id}/featured-fixture

Group: Teams

Returns the match the source highlights for a team, which is normally its next fixture or the one it is playing right now.

Plans: Every plan, Free included.

Note: While the match is live, score and clock are accurate to the second.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | DataSportsAPI team id, a positive integer |

## Response

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

## Errors

- 404 no_data — the source is not highlighting any match for this team at the moment; 404 not_found — DataSportsAPI has never assigned this id

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/teams/{id}/featured-fixture"
```

TypeScript:

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

Python:

```python
res = client.teams.featured_fixture(id)
```

Go:

```go
res, err := client.Teams.FeaturedFixture(ctx, id)
```

CLI:

```bash
$ dsa teams featured-fixture <id>
```

## Example response

```json
{ "data": { "id": 701540, "sport": "football", "status": { "type": "notstarted", … }, "startTime": "2026-11-04T17:45:00.000Z",
    "league": { "id": 195900, "name": "UEFA Champions League", … }, "home": { "id": 3120, "name": "SK Slavia Praha", … },
    "away": { "id": 18, "name": "Arsenal", … }, … },
  "meta": {} }
```

---

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