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
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-seasons API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-seasons?key=<API_KEY>&seriesId=9237'
Query Result
Use Cases
- Build an IPL history page that lists every edition and links each season id to its own fixtures and squads.
- Add a season switcher to a tournament page so visitors move between editions of a recurring league starting from one seriesId.
- Create a champions and runners-up table that shows team names, short codes and logos through imageId for each year.
- Show a no-season-history state when the endpoint answers HTTP 204, rather than rendering an empty list or an error banner.
- Seed an archive index by reading isArchived and the start and end dates to separate completed editions from the current one.
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.