List live cricket matches grouped by match type and series, with match IDs, teams, venues, status text and per-innings scores where available.

View all Cricket Live Scores, Scorecards & Stats API endpoints →

Return the current live-match feed as one JSON object. The operation has no input parameters on this page, so a plain GET to /matches/v1/live is the whole request. The source spec also mentions optional country-code and UTC-offset request headers, but they are not exposed here, so no locale or time-zone shaping is documented. A probe call returned HTTP 200 with a JSON object containing typeMatches, an array of groups that each have a matchType label (International, League, Domestic and Women were observed) and a seriesMatches array; filters.matchType, an array listing the same group labels; appIndex, an object with seoTitle and webURL text; responseLastUpdated, a string; and contentFilters, an array of filterId and filterName pairs (a liveStream filter was observed). Each seriesMatches entry is either a seriesAdWrapper, which holds seriesId, seriesName and a matches array (some wrappers also carried isLiveStreamEnabled), or a placeholder ad object with name, layout and position that should be skipped when listing matches. Each match has a matchInfo object and, for most probed matches, a matchScore object. matchInfo carries matchId, seriesId, seriesName, matchDesc, matchFormat (for example T20 or TEST), state and stateTitle (probe values included In Progress, Toss, Innings Break, Stumps, Badlight and Complete), status, hideScoreStatus, startDate and endDate as epoch-millisecond strings, isTimeAnnounced, team1 and team2 (teamId, teamName, teamSName, imageId) and venueInfo (id, ground, city, timezone, latitude, longitude); currBatTeamId, isFantasyEnabled and livestreamEnabled appear only on some matches. matchScore holds team1Score and team2Score, each with innings objects such as inngs1 containing inningsId, runs, wickets and overs. Everything listed above was seen in the probe sample or the source example; treat optional fields as absent-able, because the sample is a single snapshot and not a guaranteed contract. The result reflects whatever is live at request time, so a short or empty list is possible, and the endpoint does not promise a particular latency or coverage of every competition.

API Features

Match-type grouped feed Matches arrive inside typeMatches groups labelled International, League, Domestic and Women, and filters.matchType repeats those labels so tabs can be built without hard-coded names.
Series-nested live records Each seriesAdWrapper bundles seriesId, seriesName and a matches array, so a live page can show one block per tournament or tour with its fixtures underneath.
Live state vocabulary state, stateTitle, status and hideScoreStatus expose the current phase of play; the probe saw In Progress, Toss, Innings Break, Stumps, Badlight and Complete, plus free-text status lines.
Per-innings score objects Where a match has started, matchScore carries team1Score and team2Score with inngs1-style objects holding inningsId, runs, wickets and overs for a compact score line.
Snapshot marker and stream flags responseLastUpdated stamps the snapshot, while contentFilters, isLiveStreamEnabled and livestreamEnabled hint at which live items have a stream so cards can show a badge.

Live API Demo

GET /api/project/cricbuzz-cricket/matches-live

No parameters required. Click Query to call the API.

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/matches-live?key=<API_KEY>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Does the live matches endpoint need any inputs?

No. This page exposes no input parameters, so you send a plain GET to /matches/v1/live. The source spec mentions optional country-code and UTC-offset headers, but they are not configurable here, so do not assume locale-specific or time-zone-shifted output.

How do I go from a live card to one specific match?

Read matchInfo.matchId from the match you want, together with seriesId if you also need the tournament. These are numeric identifiers that you can reuse in other match-level requests.

What is in seriesMatches besides matches?

The probe returned two entry shapes: a seriesAdWrapper with seriesId, seriesName and matches, and a placeholder ad object with name, layout and position. Skip entries that have no seriesAdWrapper when you render the match list.

Why do some live matches have no matchScore?

In the probe sample most, but not all, matches carried matchScore. Treat matchScore, currBatTeamId and the boolean flags as optional, and fall back to status or hideScoreStatus when a score object is missing.

What time format do startDate and endDate use?

They are epoch-millisecond values returned as strings, so parse them as numbers before converting. venueInfo.timezone gives the ground's UTC offset, for example +09:00, which you can use to show local kickoff times.

What does responseLastUpdated mean?

It is a string stamp for the snapshot. In the samples it looks like a Unix timestamp in seconds, but the format is not documented, so verify it in your own response before relying on it for freshness checks.

Is the list guaranteed to be complete or real-time?

No. It is a snapshot of what the feed lists as live at request time. It can be short or empty, it may not include every competition, and no particular latency is promised.

Related operations

Guides

View Subscription Plans →