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
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/cricbuzz-cricket/matches-live No parameters required. Click Query to call the API.
API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/matches-live?key=<API_KEY>'
Query Result
Use Cases
- Drive a live-match discovery page from the typeMatches array and the matchType filters, keeping the appIndex object separate from the match records.
- Build a score ticker that reads runs, wickets and overs from matchScore for each innings and falls back to the status text when no score object is present.
- Collect matchId values from live fixtures and hand the selected one to match-center, scorecard or commentary requests.
- Add a streaming or fantasy-eligible badge to live cards using the livestreamEnabled and isFantasyEnabled flags when they are present.
- Store the responseLastUpdated string with each poll so a dashboard can show how old its live snapshot is.
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.