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

Group: Fixtures

Past and scheduled meetings of the two teams, returned as fixtures sorted by kick-off (oldest first); the fixture you asked about is excluded.

Plans: Every plan, Free included.

Note: Each item carries all Fixture fields in their list form, so those only /v2/fixtures/{id} fills (referee and the like) are null. Meetings from before your plan’s history window are omitted, with meta.historyFrom giving the first day included. Teams that have never met produce an empty array.

## Parameters

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

## Response

- `data`: `Fixture[]`
- `meta`: count, and historyFrom if your plan caused older meetings to be dropped
- Objects: Fixture (https://datasportsapi.com/markdown/reference.md#fixture)

## Errors

- 403 history_not_in_plan — kick-off falls before the start of your plan’s history window

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

TypeScript:

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

Python:

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

Go:

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

CLI:

```bash
$ dsa fixtures h2h-fixtures <id>
```

## Example response

```json
{ "data": [ { "id": 456, "sport": "football", "startTime": "2015-09-19T14:00:00.000Z",
    "status": { "type": "finished", "phase": "finished", "code": 100, "description": "Ended", "period": null, "finish": "regular" },
    "home": { "id": 3758, "name": "Arsenal", … }, "away": { "id": 17000, "name": "Nottingham Forest", … },
    "homeScore": { "current": 2, … }, "awayScore": { "current": 0, … }, "winner": "home", … }, … ],
  "meta": { "count": 7 } }
```

---

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