List auction players by completed, upcoming or live state

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

Retrieve the auction player list for a required status: completed covers auction results including sold, unsold, retained and RTM; upcoming covers players yet to be auctioned; live covers the current auction state with editor picks. The configured status is completed, tournament is ipl, year is the string 2026 and currency is INR. Optional filters are cap (Capped or Uncapped), countryId, role (Batter, Bowler, Allrounder or WK-Batter) and teamId. Use sort from a response-provided sort ID, or use sortField with sortDirection (ASC or DESC) from the same documented sort option. Leave timestamp unset for the first page; for another page, pass the last returned player's updatedTime as the numeric timestamp parameter. No timestamp unit or page-size parameter is documented. The truncated, unverified documentation example shows appIndex with seoTitle and webURL and an auctionPlayersList array. Visible player fields include playerId, playerName, playerImageId, role, country, countryId, cappedStatus, season, auctionStatus, auctionPrice, basePrice, playsFor, playsForTeam, teamImageId, totalEarnings, updatedTime, id and a playerIntro text array. The excerpt also contains editorPickLabel, isEditorPick, isPlayerOverseas, twitterArticleId and videoAnalysisId on some entries; these fields are not established as universal. Parameter documentation separately references filters, filter.team, sortFilter.sort[].id and sort.options with value1/value2 as input-discovery fields. No response for this operation was observed in the saved probe evidence, and the truncated example does not confirm complete list coverage, response structure for every status or live-update frequency.

API Features

Three auction-state views Choose completed for results, upcoming for players awaiting auction or live for the current auction state with documented editor-pick context.
Capped-status and role shortlists Narrow a player list with Capped or Uncapped and one documented role: Batter, Bowler, Allrounder or WK-Batter.
Response-discovered country and team filters Use countryId and teamId from the documented response filter metadata rather than assuming a fixed universal set of country or franchise identifiers.
Paired sorting controls Select a documented sort ID or pair a response option's value1 with its value2 through sortField and sortDirection; precedence when both methods are supplied is unspecified.
Last-player continuation value Omit timestamp for the initial page and use the last player's updatedTime for continuation, preserving the selected status and edition rather than inventing page numbers.
Currency-aware result browsing Set currency for documented price notation while listing an IPL or WPL edition; INR is the default, with USD and GBP given as examples.

Live API Demo

GET /api/project/cricbuzz-cricket/auction-list-players

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/auction-list-players?key=<API_KEY>&status=completed&currency=INR&tournament=ipl&year=2026'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What do completed, upcoming and live mean for the player list?

completed requests auction results, including sold, unsold, retained and RTM outcomes. upcoming requests players yet to be auctioned. live requests the current auction state with editor picks. No saved probe response verifies the current contents or update frequency of these views.

Which role and capped-status filters can I supply?

cap accepts Capped or Uncapped. role accepts Batter, Bowler, Allrounder or WK-Batter. Both are optional string query parameters; omitting them avoids setting those filters.

Where should countryId and teamId filter values come from?

The parameter documentation points to filters for countryId and filter.team for teamId in the response. It gives countryId 4 for Australia and teamId 58 for CSK as examples, not as a complete list of identifiers.

How do I choose a sorting method?

Set sort to an ID documented at sortFilter.sort[].id. Alternatively, set sortField from value1 of a sort.options entry and sortDirection from that same entry's value2, which is ASC or DESC. The documentation does not specify precedence if both methods are sent.

How is the next auction player-list page requested?

Leave timestamp empty for the first page. For continuation, use the updatedTime of the last returned player as timestamp. The declared timestamp input type is number; its time unit and page size are not documented. There is no page-number input.

How do tournament, year and currency affect this list?

tournament selects ipl or wpl, year is an auction-year string, and currency controls documented price formatting. The configured defaults are ipl, 2026 and INR. Discover available editions through the auction-seasons endpoint. INR, USD and GBP are currency examples; unknown currency values are documented to omit the symbol.

Are editor-pick and video-related fields guaranteed for every player?

No. The truncated source example contains editorPickLabel, isEditorPick, twitterArticleId and videoAnalysisId on some entries, but no endpoint-specific probe confirms their availability. An identifier does not itself supply a video file or content usage rights.

Related operations

Guides

View Subscription Plans →