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
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/auction-list-players API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/auction-list-players?key=<API_KEY>&status=completed¤cy=INR&tournament=ipl&year=2026'
Query Result
Use Cases
- Build separate completed-results, upcoming-pool and live-auction tabs, keeping each status distinct instead of combining their meanings.
- Create a recruitment research shortlist using capped status, role, country and team filters within one selected auction edition.
- Populate a completed-auction review table with returned sold, unsold, retained and RTM outcomes without presenting upcoming players as final results.
- Support a load-more auction table by retaining the last returned updatedTime and the same filter and sorting selection for the next request.
- Offer editor-pick annotations on a live-auction list only where the returned entries actually include the documented pick fields.
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.