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
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.
The endpoints around the board
The board tells you what is happening now. These calls fill in the rest of a match centre, and every one of them works on the Free plan.
- GET
/v2/livescoresLive scoresEvery match in play across all sports, or one sport with ?sport=.All plans - GET
/v2/fixtures/{id}FixtureOne match in full: venue, round, referee, managers and the live state.All plans - GET
/v2/fixtures/{id}/eventsEventsGoals with scorers, cards, substitutions and period markers, oldest first.All plans - GET
/v2/fixtures/{id}/lineupsLineupsBoth line-ups with formations and per-player match statistics.All plans - GET
/v2/fixtures/{id}/statisticsStatisticsTeam statistics by period: possession, shots, fouls and the sport's own figures.All plans - GET
/v2/fixturesFixtures by dateA day's schedule by sport, league or country, with live scores filled in.All plans - GET
/v2/fixtures/countsFixture countsHow many matches are on today and how many are live, without paging.All plans - GET
/v2/races/{id}/resultsRace resultsMotorsport and cycling: the running session's classification.All plans
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"{
"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
livescoresandsport:{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.
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 detailsStarter
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 detailsPro
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 detailsBusiness
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 detailsEnterprise
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.
Keep reading
More of the sports data API
Other ways in
- Real-time sports APIA WebSocket with snapshots, deltas and replay, plus signed webhooks, from the Business plan up.Read more
- Free sports APIThe core match data for all 24 sports on the Free plan, with no card to sign up.Read more
- Betting odds APIPre-match and in-play prices per fixture from Pro, a day of markets in one call, live moves from Business.Read more
- Historical sports dataFinished seasons over REST, back to 1920 on Enterprise, or as JSON, CSV and Parquet season files.Read more
- Sports statistics APIMatch stats by period, player and team season totals, xG, ratings and league leaderboards.Read more
Sport by sport
In the docs
- Live scores referenceParameters, response fields and errors
- Data freshnessHow old each endpoint's data can be
- WebSocket streamSnapshots, deltas and replay
- Building a live score appThe calls, the code and the plan
- Fixture objectEvery field of the data reference
- API playgroundTry the live board in your browser
Put the live board in your app today.
1,000 free requests a day during the beta. No card, no sales call.













