# GET /v2/livescores

Group: Live scores

All in-progress fixtures across every sport, or one sport’s in-play board with ?sport= (each listed match as the live index holds it — the same state as the no-sport form and the WebSocket). Stale rows (no change for 45 min and started longer ago than the sport can last) are left out, here and on the WebSocket.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | no | a sport slug from /v2/sports, e.g. football |

## Response

- `data`: `Fixture[]`
- `meta`: count, plus sport when filtered
- Objects: Fixture (https://sportsapi.app/markdown/en/reference.md#fixture)

## Errors

- 400 bad_request — unknown sport

Plus the common errors (https://sportsapi.app/markdown/en/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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, &sportsapi.LivescoresListParams{})
```

CLI:

```bash
$ sportsapi 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.sportsapi.app/v2/teams/17000/logo", … },
    "away": { "id": 3758, "name": "Arsenal", "code": "ARS", "image": "https://cdn.sportsapi.app/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, "firstToServe": null, … } ],
  "meta": { "sport": "football", "count": 1 } }
```

---

Base URL: https://api.sportsapi.app. Send your API key as `Authorization: Bearer <key>` on every /v2 request; keys are created in the dashboard (https://sportsapi.app/dashboard).
HTML: https://sportsapi.app/docs/livescores/list · All docs: https://sportsapi.app/markdown/en/docs.md