# GET /v2/livescores

Group: Live scores

Returns every live fixture across all sports, or one sport’s in-play board when ?sport= is set; each match reflects the live index, so its state is identical to the unfiltered call and to the WebSocket. Stale entries — no change for 45 min, and a start further back than a match in that sport can run — are dropped both here and on the WebSocket.

Plans: Every plan, Free included.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | no | sport slug as listed by /v2/sports, for example football |

## Response

- `data`: `Fixture[]`
- `meta`: count, and sport if a filter was applied
- Objects: Fixture (https://datasportsapi.com/markdown/reference.md#fixture)

## Errors

- 400 bad_request — the sport slug is not recognised

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/livescores"
```

TypeScript:

```ts
const { data, meta } = await client.livescores.list();
```

Python:

```python
res = client.livescores.list()
```

Go:

```go
res, err := client.Livescores.List(ctx, &datasportsapi.LivescoresListParams{})
```

CLI:

```bash
$ dsa livescores list
```

## Example response

```json
{ "data": [ { "id": 201324, "sport": "football",
    "status": { "type": "inprogress", "phase": "inprogress", "code": 7, "description": "2nd half",
                "period": "period2", "finish": null },
    "startTime": "2026-10-18T15:30:00.000Z",
    "home": { "id": 17000, "name": "Nottingham Forest", "code": "NFO", "image": "https://cdn.datasportsapi.com/v2/teams/17000/logo", … },
    "away": { "id": 3758, "name": "Arsenal", "code": "ARS", "image": "https://cdn.datasportsapi.com/v2/teams/3758/logo", … },
    "homeScore": { "current": 0, "periods": { "period1": 0, "period2": 0 }, "tieBreaks": {}, "normalTime": null,
                   "penalties": null, "aggregated": null, "series": null, "point": null, "redCards": 0,
                   "innings": {}, "hits": null, "errors": null },
    "awayScore": { "current": 1, "periods": { "period1": 0, "period2": 1 }, "redCards": 0, … },
    "clock": { "periodStartedAt": "2026-10-18T16:32:10.000Z", "periodOffsetSeconds": 2700, "periodEndSeconds": 5400,
               "maxExtraSeconds": 540, "injuryTimeMinutes": null, "playedSeconds": null, … },
    "league": { "id": 195828, "name": "Premier League", "category": "England",
                "country": { "code": "EN", "name": "England" }, … },
    "winner": null, "serving": null, "servedFirst": null, "firstToServe": null, … } ],
  "meta": { "sport": "football", "count": 1 } }
```

---

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