Live scores

GET

https://api.datasportsapi.com/v2/livescores

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 0 required · 1 optional
Returns: Fixture[]

Try in Playground WebSocket stream guide

Returns every live fixture across all sports, or a single sport’s in-play board when ?sport= is given.

Each match reflects its state in the live index, which 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.

01Parameters

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

sportqueryOptional
sport slug as listed by /v2/sports, for example football

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/livescores"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data: Fixture[]
meta: count, and sport if a filter was applied

ObjectsFixture

Example response

16 lines

{ "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, "firstToServe": null, … } ],
  "meta": { "sport": "football", "count": 1 } }

04Errors

400bad_request
the sport slug is not recognised

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code