Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

Live now matches in play

Live scores · REST · WebSocket

Live scores API for 24 sports

DataSportsAPI is a live scores API with one board for every sport: a single request to /v2/livescores returns each match in play with its score, status and clock current to the second. Add ?sport=football, or any other sport slug, for one sport's board; the same matches stream over WebSocket when polling stops being enough.

  • Every plan, Free included
  • 22 fixture sports on one board
  • Live state to the second
  • Push from Business up
Livematches in play

Open Matchboard (opens in a new tab)

The data

What a live score response holds

Each entry in data is a complete Fixture, the same object every other endpoint returns: our fixture id, the sport, both sides with their ids, names, short codes and logos on our CDN, the competition and its country or tour, and the kick-off time in UTC. The live part is three objects. status says where the match stands, as a type, a phase, the current period and a label such as “2nd half”. homeScore and awayScore hold the current score and every period, plus extra time, penalties and the counters a sport needs, from red cards to innings, hits and errors. clock gives the moment the current period began and how far into it the match is, so you can tick the minute on screen without asking again every second.

Because every sport arrives in this one shape, a single renderer copes with a Premier League match, an NBA game, a tennis set or an esports map. Fields a sport does not use come back as null or empty instead of disappearing, so your parser never has to guess. Matches that the source has left hanging, with no change for 45 minutes and a kick-off further back than the sport can run, are dropped, so an abandoned game never sits on your board all night.

First request

Your first live score request

Send your secret key as a Bearer token from your server; it starts with sk_live_ and never belongs in a browser. The SDKs read it from DATASPORTSAPI_API_KEY, so the snippets below run as they are once the variable is set.

The response is the usual { data, meta } envelope. meta.count is the number of matches in play, and meta.sport echoes the filter when you set one. Call the endpoint without a filter and you get the whole board, every sport, in that same single request.

# Every match in play, all sports
curl "https://api.datasportsapi.com/v2/livescores" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# One sport's board
curl "https://api.datasportsapi.com/v2/livescores?sport=basketball" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
200 OK · trimmed
{
  "data": [
    {
      "id": 201324,
      "sport": "football",
      "status": { "type": "inprogress", "phase": "inprogress", "code": 7,
                  "description": "2nd half", "period": "period2" },
      "startTime": "2026-10-18T15:30:00.000Z",
      "home": { "id": 17000, "name": "Nottingham Forest", "code": "NFO" },
      "away": { "id": 3758, "name": "Arsenal", "code": "ARS" },
      "homeScore": { "current": 0, "periods": { "period1": 0, "period2": 0 }, "redCards": 0 },
      "awayScore": { "current": 1, "periods": { "period1": 0, "period2": 1 }, "redCards": 0 },
      "clock": { "periodStartedAt": "2026-10-18T16:32:10.000Z",
                 "periodOffsetSeconds": 2700, "periodEndSeconds": 5400 },
      "league": { "id": 195828, "name": "Premier League", "category": "England" }
      // … venue, round and the rest of the Fixture object
    }
  ],
  "meta": { "count": 1, "sport": "football" }
}

Freshness

How live is live?

Live state is never cached: we apply it as each response is served. The rest of a match has its own rhythm, and these are the worst cases with a healthy source.

Score, status, clock
To the secondApplied from the live feed at the moment we answer, on the board and anywhere else a Fixture appears.
Kick-off on ?sport=
About a minuteA match that has just started joins a one-sport board within about a minute; one that ends leaves it at once.
Events, lineups, statistics
About 30 secondsRe-read on a short cycle while the match is in play, never more than 90 seconds behind, then settled.
WebSocket push
SecondsOn Business and Enterprise the livescores and sport:{slug} channels deliver each change within seconds of the feed.
Score corrections
1.5 s holdA score that goes down is pushed within 1.5 seconds of the source (5 in football), which filters out brief flaps.
Stale matches
DroppedNo change for 45 minutes and a kick-off too long ago for the sport: off the board and off the stream.

Coverage

One live board, every sport we cover

Football live scores sit next to NBA quarters, tennis sets, cricket innings, MMA rounds and esports maps, all in the same list and the same shape. Pick a sport to see what its fixtures carry on top of the shared core.

Plans

Live scores are on every plan

The board, the match detail around it and all the sports are in every plan. What changes with the plan is how much you can call, how far back you can read and whether changes are pushed to you.

  1. Free

    Included

    $0 a month

    • 1,000 requests / day
    • 10 requests a minute
    • Last 7 days of history

    The full board for every sport, enough for a prototype, a personal project or a first look at the data.

    Free plan details
  2. Starter

    Included

    $49 a month

    • 250,000 requests / month
    • 120 requests a minute
    • Last 30 days of history

    The same board with room to poll from your server every 15 seconds, all month.

    Starter plan details
  3. Pro

    Included

    $199 a month

    • 1,000,000 requests / month
    • 600 requests a minute
    • Last 6 months of history

    Adds play-by-play, momentum, win probability, betting odds and the live score widgets.

    Pro plan details
  4. Business

    Included

    $1,500 a month

    • 5,000,000 requests / month
    • 3,000 requests a minute
    • Last 12 months of history

    Adds the WebSocket stream with replay and webhooks, so changes come to you.

    Business plan details
  5. Enterprise

    Included

    $2,500 a month

    • 10,000,000 requests / month
    • 6,000 requests a minute
    • Full history

    Adds the tracking data (ball, events, live timelines, NBA player positions) and the live match tracker widget, with the most volume and live connections.

    Enterprise plan details

Questions

Live scores API, answered

Anything else? The full FAQ covers quota, plans and the data in general.

Is the live scores API free to use?

Yes. /v2/livescores answers on every plan, Free included, for every sport we cover. Free allows 10 requests a minute and 1,000 a day while the beta runs (100 after it). The paid plans raise the quota and the rate; the response itself is identical on every one of them.

How quickly do the live scores update?

Status, score, clock and winner are copied from the live feed at the moment we answer, so a REST response is current to the second it is served. How current your screen is depends on how often you ask. On Business and Enterprise the WebSocket removes the guesswork: each change is pushed within seconds of the feed, and a lowered score (a goal ruled out, a corrected basket) follows within 1.5 seconds, 5 in football.

Which sports are on the live board?

It is a live sports scores API for every sport at once: all 22 fixture sports share one board, from football, basketball, tennis and ice hockey to cricket, esports, darts and padel. Cycling and Motorsport are races rather than head-to-head matches: their running session's classification comes from /v2/races/{id}/results, and from Business up the race:{id} channel pushes it.

Can I get live scores for one league or one team only?

Over REST, filter by sport with ?sport=, then by league.id or by the two team ids in your own code; the all-sports board is a single request either way. For a league's day with kick-off times as well as live scores, /v2/fixtures?date= takes a league= filter. From Business up the WebSocket has league:{id} and team:{id} channels, so you only receive the matches you follow.

Do live scores include goal scorers, cards and lineups?

The board carries what a scoreline needs: score by period, status, clock and red cards. Scorers, bookings and substitutions come from /v2/fixtures/{id}/events and line-ups from /v2/fixtures/{id}/lineups, both refreshed roughly twice a minute during play and both on every plan.

Can I show live scores on a website without writing code?

Yes, with the embeddable widgets, on Pro and every plan above it. One script tag from https://api.datasportsapi.com/widgets/v1.js and a publishable pk_live_ key, locked to your domains, render a live score board that refreshes itself.

Put the live board in your app today.

1,000 free requests a day during the beta. No card, no sales call.