Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Live scoresReal time

Live wire

GET

/v2/livescores/wire

Business and up

View as MarkdownTry in Playground →

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.

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

sport

query

sport slug; only that sport’s moments (all sports when left out)

since

query

ISO 8601 instant; only moments after it, for example the newest at you already hold

before

query

ISO 8601 instant; only moments before it, which pages backwards (send the oldest at you received)

limit

query

number of moments, 1–100 (30 when left out)

Response

meta
count, sport (null when not filtered), limit
errors
400 bad_request — the sport is not recognised, since or before is not an ISO instant, or limit is outside 1–100

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/livescores/wire"
Example
{ "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 } }