List all seasons of a recurring cricket series by seriesId

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

Returns the season history of a recurring competition, 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 a seasons array in which each season has id, name, shortName, season (year label), seriesType, host (comma-separated countries), startDate and endDate as epoch-millisecond strings, isArchived, and winner and runnerUp team objects (teamId, teamName, teamSName, imageId, isActive, isLeagueTeam, teamPriority and, on some teams, isVideoPresent). A series without season history answers HTTP 204 with an empty body, and in testing only IPL editions returned season data, so do not assume other recurring series work. The fields shown are from a source example rather than a live probe.

API Features

Edition history for one competition A single seriesId returns the list of seasons of a recurring league, so an archive page can enumerate every edition without separate lookups.
Winner and runner-up teams Each season embeds winner and runnerUp team objects with teamId, teamName, teamSName and imageId, ready for a champions table with logos.
Season identity and labels Fields id, name, shortName, season and seriesType give a season-level seriesId plus display labels such as an edition name and year.
Host countries and date window The host string can list several countries, and startDate and endDate epoch values mark when each edition was played.
Archive status flag The isArchived boolean on each season separates completed editions from ones that are still current, which helps order and badge the history list.
Explicit no-history signal A series with no season history answers HTTP 204 with no content, which is a clean cue to show an empty state instead of a parse error.

Live API Demo

GET /api/project/cricbuzz-cricket/series-get-seasons

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/series-get-seasons?key=<API_KEY>&seriesId=9237'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Which series return season data?

In testing, only IPL editions returned data, and other series answered HTTP 204. That is an observation about the tested ids, not a guarantee for every recurring series, so keep the 204 path in your client.

What does an HTTP 204 response look like?

It means the series has no season history. The source documents an empty body for it, so check the status code before parsing JSON and show a no-history message instead of an empty table.

Can I pass the id of any edition?

The source example for the default seriesId 9237 (the IPL 2025 edition) lists that same id inside the returned seasons array next to other editions, which suggests any edition id of the competition can be used. This comes from a source example, not a live probe, so verify with your own ids.

How are the dates formatted?

startDate and endDate are epoch-millisecond values serialized as strings in the source example. Convert them on the client before showing a season window.

Does this endpoint list the matches of each season?

No. It returns season summaries only. Pass a season's id as seriesId to the series matches or squads endpoints of this product to load fixtures or rosters for that edition.

Where do I find a seriesId to start from?

Take the id field from the series list or archived series list endpoints. The default 9237 is an example value from the source documentation.

Related operations

Guides

View Subscription Plans →