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

Group: Teams

Returns one page of a team’s fixtures, either recent or upcoming.

Plans: Every plan, Free included.

Note: If the team exists but has nothing to list, the response is 200 with an empty array. Since 2026-10-24 every competitor list splits matches the same way. upcoming holds matches not yet started (including ones postponed to a future date), soonest first, and page 0 also includes a next match that the source has filed under recent (tennis players, fighters). recent holds live, finished and called-off matches, with the newest at the top of every page. For a live or just-finished match, status, score and clock are accurate to the second. Once a match kicks off it moves to recent on your next request, and both lists are rebuilt on the first request after any of the team’s matches ends, is rescheduled or is postponed (see Data freshness).

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | DataSportsAPI team id, a positive integer |
| `type` | query | no | recent \| upcoming; upcoming when omitted |
| `page` | query | no | zero-based page number, a whole number from 0 to 50 (defaults to 0) |

## Response

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

## Errors

- 400 bad_request — type is neither recent nor upcoming, or 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/teams/{id}/fixtures"
```

TypeScript:

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

Python:

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

Go:

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

CLI:

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

## Example response

```json
{ "data": [ { "id": 202006, "status": { "type": "finished", … }, … } ],
  "meta": { "type": "recent", "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/teams/fixtures/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
