# GET /v2/livescores/wire

Group: Live scores

Recent moments from the livescores channel, newest first, reaching back 7 days: score changes of any kind (goals, baskets, sets and runs, including corrections that lowered a score), red cards, kick-offs, period starts, breaks and final whistles. Every moment carries the score and status as they stood just after it, plus the ids and names of both sides, which is enough to fill a ticker before the WebSocket has delivered anything, or to show a client what happened while it was away for longer than replay covers. Each moment has exactly one kind, the first that fits in the order score, redCard, finished, break, kickoff, period. Available since 2026-11-16.

Plans: Business and up; other plans receive 403 endpoint_not_in_plan.

Note: Nothing older than 7 days is kept. The moments are recorded from the same changes the livescores channel publishes, as we publish them, and at is that publication time. To combine them with live deltas, match on fixtureId + kind + score.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | no | sport slug; only that sport’s moments (all sports when left out) |
| `since` | query | no | ISO 8601 instant; only moments after it, for example the newest at you already hold |
| `before` | query | no | ISO 8601 instant; only moments before it, which pages backwards (send the oldest at you received) |
| `limit` | query | no | number of moments, 1–100 (30 when left out) |

## Response

- `data`: `LiveWireEvent[]`
- `meta`: count, sport (null when not filtered), limit
- Objects: LiveWireEvent (https://datasportsapi.com/markdown/reference.md#livewireevent)

## Errors

- 400 bad_request — the sport is not recognised, since or before is not an ISO instant, or limit is outside 1–100

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

TypeScript:

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

Python:

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

Go:

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

CLI:

```bash
$ dsa livescores wire
```

## Example response

```json
{ "data": [
    { "fixtureId": 201324, "sport": "football", "leagueId": 195828, "kind": "score", "at": "2026-11-16T16:41:07.512Z",
      "side": "away", "homeScore": 0, "awayScore": 1,
      "status": { "type": "inprogress", "phase": "inprogress", "period": "period2" },
      "home": { "id": 17000, "name": "Nottingham Forest" }, "away": { "id": 3758, "name": "Arsenal" } },
    { "fixtureId": 201331, "sport": "football", "leagueId": 195828, "kind": "break", "at": "2026-11-16T16:17:55.020Z",
      "side": null, "homeScore": 1, "awayScore": 1,
      "status": { "type": "inprogress", "phase": "break", "period": "period1" },
      "home": { "id": 2824, "name": "Brentford" }, "away": { "id": 2819, "name": "Everton" } } ],
  "meta": { "count": 2, "sport": "football", "limit": 2 } }
```

---

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