# GET /v2/livescores/wire

Group: Live scores

The live wire: the moments of the livescores channel of the last 7 days — a score (a goal, a basket, a set, a run, or a correction that took one back), a red card, a kick-off, a new period, a break, the full time — newest first. Each carries the score and status right after it and both sides’ ids and names, so a ticker can start filled before the WebSocket sends anything, and a client back from a long disconnect can see what it missed. A moment has one kind, the first that applies of score, redCard, finished, break, kickoff, period. Since 2026-11-16.

Plans: Business and up (other plans get 403 endpoint_not_in_plan).

Note: Moments older than 7 days are gone. The moments come from the same changes the livescores channel sends, recorded as we publish them; at is when we published. Merge with live deltas by fixtureId + kind + score.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | no | a sport slug: that sport’s moments only (default every sport) |
| `since` | query | no | an ISO 8601 instant: only moments after it — e.g. the newest at you hold |
| `before` | query | no | an ISO 8601 instant: only moments before it — the next page back (pass the oldest at you got) |
| `limit` | query | no | moments to return, 1–100 (default 30) |

## Response

- `data`: `LiveWireEvent[]`
- `meta`: count, sport (null for every sport), limit
- Objects: LiveWireEvent (https://sportsapi.app/markdown/en/reference.md#livewireevent)

## Errors

- 400 bad_request — unknown sport, since / before not an ISO instant, limit not 1–100

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

TypeScript:

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

Python:

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

Go:

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

CLI:

```bash
$ sportsapi livescores wire
```

## Example response

```json
$ curl -H "Authorization: Bearer sk_live_…" "https://api.sportsapi.app/v2/livescores/wire?sport=football&limit=2"

{ "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.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/wire · All docs: https://sportsapi.app/markdown/en/docs.md
