List recent and upcoming matches in a cricket series by seriesId
View all Cricket Live Scores, Scorecards & Stats API endpoints →Returns the fixtures of one cricket series, selected with the required numeric seriesId path parameter (the id value from the series list or archived series list endpoints). The source response example documents an appIndex block (seoTitle, webURL) and a matchDetails array. Each matchDetailsMap entry has a date-range key, a match list and the seriesId. Every match carries matchInfo (matchId, matchDesc, matchFormat, state, status, startDate and endDate as epoch-millisecond strings, currBatTeamId, isTimeAnnounced, team1 and team2 with teamId, teamName, teamSName and imageId, and venueInfo with ground, city and timezone) plus a matchScore object with per-team, per-innings runs, wickets, overs and declaration flags. Advertisement placeholder entries (adDetail with layout, name and position) can appear between fixtures and should be skipped. These fields come from a source example rather than a live probe, so treat optional blocks such as matchScore as coverage-dependent.
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/series-get-matches API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-matches?key=<API_KEY>&seriesId=3641'
Query Result
Use Cases
- Create a tournament match hub that lists a series' recent and upcoming fixtures under date-range headings.
- Open a selected fixture's match center by passing its matchId onward, instead of issuing a global match search for every tournament page.
- Build a bilateral-tour schedule page, for example a Test series with warm-up matches, using matchDesc and matchFormat as row labels.
- Render result lines for finished fixtures by combining the status sentence with per-innings runs and wickets from matchScore.
- Sync series fixtures into a calendar or alert feed using the startDate and endDate epoch values and the venue timezone offset.
Frequently asked questions
Where do I get the seriesId for this endpoint?
Use the id field returned by the series list or archived series list endpoints. The default value 3641 is an example id that the source response example associates with the New Zealand tour of England, 2022.
Does it return both finished and upcoming matches?
The endpoint is described as returning recent and upcoming matches for a series. The source example only shows finished fixtures with a status sentence and innings scores, and no live probe was recorded here, so for upcoming fixtures expect state and status to differ and score blocks such as matchScore to be partial or absent.
How are startDate and endDate formatted?
In the source example they are epoch-millisecond values serialized as strings. Convert them on the client and use venueInfo.timezone, a UTC offset such as +01:00, when you need to show local match time.
What are the adDetail entries inside matchDetails?
They are layout placeholders with layout, name and position fields, not matches. Skip any array element that has no matchDetailsMap when you build a fixture list.
Can I get full scorecards or commentary from this endpoint?
No. It gives a fixture list with summary scores only. Pass a matchId to the match scorecard or commentary endpoints of this product when you need batting cards, bowling figures or ball-by-ball text.
What should I do when a series returns no fixtures?
Coverage depends on the competition, so handle an empty or missing matchDetails array and any non-200 response as a normal empty state instead of retrying with a different seriesId automatically.