Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

Cricket · India · 10 teams

IPL API with live scorecards and ball-by-ball data

An IPL API for live scores, full scorecards, the points table and ball-by-ball data on league id 195830, with every season since 2013. Each innings carries runs, wickets, overs and run rate, plus the rate required in a chase, and the toss and its decision sit on the match itself.

  • 14 seasons since 2013
  • 10 teams
  • League id 195830
  • Scorecards on every plan

Indian Premier League

GET /v2/leagues/195830

League id
195830
Category
India
Archive
14 seasons since 2013
Teams
10 teams
Live channel
league:195830

In the data

The IPL in the API

What league id 195830 holds, and how its seasons are laid out.

Ten teams, one id

GET /v2/leagues/195830 returns India as the category, the Royal Challengers Bengaluru as title holder, and Chennai Super Kings and Mumbai Indians, on five titles each, in mostTitlesTeams. /seasons lists every season from 2013, newest first; the 2026 season ran from 28 March to 31 May with 10 teams, which /teams?season= returns. /champions gives the winners of the last ten seasons with the year each season finished.

Innings, overs and the toss

An IPL score is kept by innings, not by period: each side's innings holds inning1 and on, with runs, wickets, overs, runRate and, for the side chasing, targetRunRate. Overs are written in cricket notation, so 17.4 is 17 overs and 4 balls. /v2/fixtures/{id} names the side at the crease in battingSide, records who won the toss and whether they chose to bat or bowl, lists the umpires and holds the note that becomes the result line once the match ends; fixture lists and the live board leave the toss and the umpires null.

Scorecards and every delivery

On every plan, /v2/fixtures/{id}/scorecard gives each innings a batting card with runs, balls, fours, sixes, strike rate and dismissal, a bowling card with overs, maidens, economy, wides and no-balls, then the falls of wicket and the partnerships. From Pro, /v2/fixtures/{id}/points breaks the innings into overs and balls, each with its outcome, runs, extras, any dismissal, the wagon-wheel shot and the pitchedAt spot for a pitch map. The odds, also from Pro, include markets on the toss winner, the most sixes and a fifty or a hundred in the match.

First request

The IPL in three calls

Every call starts from the league id, 195830. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.

The answers use the usual { data, meta } envelope and the same field names as every other cricket competition, so the code works unchanged for the next league you add.

# Every season, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/195830/seasons" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# The season's points table
curl "https://api.datasportsapi.com/v2/leagues/195830/standings?season={seasonId}" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# The winners of the last ten seasons
curl "https://api.datasportsapi.com/v2/leagues/195830/champions" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
GET /v2/leagues/195830 · trimmed
{ "data": {
    "id": 195830, "name": "Indian Premier League", "sport": "cricket",
    "category": "India",
    …
} }

History

How much of the IPL each plan reads

The archive goes back to 2013. Each plan reads back a set time from today; nothing live or upcoming is ever held back.

TopicHistoryWhat it covers of the IPL
FreeLast 7 daysLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 7 days.
StarterLast 30 daysLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 30 days.
ProLast 6 monthsLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 6 months.
BusinessLast 12 monthsLive and upcoming games, the table and statistics of a season still being played, and finished games from the last 12 months.
EnterpriseFull historyThe whole archive: 14 seasons since 2013.

Questions

IPL API, answered

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

How do I keep the IPL apart from football's Premier League?

Pin the id, 195830. GET /v2/search?q=premier league returns the IPL next to the football Premier League and other competitions with that name, each hit naming its sport, so matching on the name alone can pick the wrong one.

Is there ball-by-ball data for IPL matches?

Yes, from Pro. /v2/fixtures/{id}/points nests innings, overs and balls, and every ball names its batter and bowler and gives the outcome (one of dot, runs, four, six, wicket, wide, noBall, legBye, bye or other), the runs, any dismissal and the score after it. sequence puts deliveries in order across the whole match, ball counts past 6 in an over with wides or no-balls, and since 4 November 2026 each ball also carries the source's English commentary.

Can I show who is on strike and who is bowling?

Yes, on every plan: the scorecard's current names the striker, the non-striker and the bowler, with the over and the legal balls bowled in it so far. We work it out from the ball-by-ball data rather than the source's own current-batter field. It is null when no innings is under way, and the bowler stays null between overs until the next one delivers.

How far back does IPL data go?

To 2013: the archive holds 14 seasons of the IPL. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming games, and the table and statistics of a season still being played, are open on every plan.

Can I follow IPL games live on the free plan?

Yes. Live and upcoming games are never held back by a plan, so a Free key follows every IPL game in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:195830 pushes every change instead.

Keep reading

Other competitions

Everything in the cricket data Sports statistics API Live scores API

Build on the IPL today.

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