Get an over-by-over summary of a cricket innings by match ID
View all Cricket Live Scores, Scorecards & Stats API endpoints →Returns the over-by-over summary of a cricket match. The path parameter `matchId` is required (default 41881) and comes from the match list, schedule, series, team and venue match endpoints. Three optional query parameters control which part of the match is returned: `iid` is the innings id (for example 1), `tms` is the paging cursor and `restrictInningsId` is a boolean. Leave `tms` empty to load the first page; to load the next page pass an epoch timestamp in milliseconds (for example 1640883600000) taken from the `timestamp` field returned by this same endpoint. When `restrictInningsId` is true, paging with `tms` stops at the start of the innings given in `iid` and returns HTTP 204 instead of continuing into the previous innings. These behaviours come from the catalog parameter notes and are not verified by a probe, because no probe call was recorded for this operation. The source response example attached to this operation is truncated and unverified. Its visible part, from a completed under-19 ODI group match, is a `matchheaders` object (matchdesc, matchformat, state, status, seriesid, seriesname, team1, team2, teamdetails, tossresults, winningteamid and match start and end timestamps) followed by a `miniscore` object (batsmanstriker, bowlerstriker, batteamscore, crr, curovsstats, custstatus, event, inningsid, inningsnbr, inningsscores, lastwkt). The per-over list itself is not visible in that excerpt, so confirm the over field names against a real response. The example uses the plural key `matchheaders`, while the compact scorecard example uses `matchheader`.
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/match-details-get-overs API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-overs?key=<API_KEY>&matchId=41881'
Query Result
Use Cases
- Build an innings-specific over summary review by combining matchId with the iid of the innings you want to study.
- Load a long innings in pages by passing the last timestamp back as tms, instead of requesting every over at once.
- Limit a second-innings chase view to that innings by setting restrictInningsId to true and treating a 204 as the end of the innings.
- Create an overs list in which each row links to a ball-level detail page using that row's timestamp value.
- Test paging and restrictInningsId behaviour on a few matches in a staging harness before deriving navigation rules for a production match centre.
Frequently asked questions
What does this operation return?
The catalog describes it as an over-by-over summary of an innings for the selected match. The truncated source example visibly shows a matchheaders object and a miniscore object; the per-over list is not visible there, so confirm its field names with a real response for your own matchId.
Which parameters are required?
Only the numeric matchId path parameter is required (default 41881). iid, restrictInningsId and tms are optional and have no documented defaults, so a minimal request can send matchId alone.
How does paging with tms work?
Leave tms empty to load the first page. To load the next page, pass an epoch timestamp in milliseconds taken from the timestamp field returned by this same endpoint. The catalog does not state the page size or the ordering rule, so check the real response before automating a loop.
What does restrictInningsId do?
When it is true, paging with tms stops at the start of the innings named in iid and the catalog says the call returns 204 rather than continuing into the previous innings. Handle a 204 as the end of that innings and not as a failure. This behaviour is documented but not probe-verified.
Has the response been verified by a probe?
No. No probe call was recorded, and the source example is truncated before the over list. Treat every field name and the paging behaviour as unverified until you have compared them with a real response.
How do I open the detail of one over?
Use the timestamp of the over as tms, together with the same matchId and iid, in the over-details operation. That operation requires iid and tms and has no over-number parameter.
Why is the header key matchheaders here but matchheader in the mini scorecard?
The two source examples use different key names for what looks like the same kind of match header block. Do not share one parser between them without checking the key name for each operation.