# List bounty URL: https://docs.hanzo.ai/docs/openapi/leaderboard/get-leaderboard-bounty > Returns the ranked bug hunters and bounty contributors, and the recent bug and bounty awards. `GET /v1/leaderboard/bounty` > [Leaderboard →](https://docs.hanzo.ai/docs/openapi/leaderboard) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | ------------- | -------------------------------------------- | | **Address** | `https://api.hanzo.ai/v1/leaderboard/bounty` | | **Method** | `GET` | | **Operation** | `get_leaderboard_bounty` | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | Returns the ranked bug hunters and bounty contributors, and the recent bug and bounty awards. ## Request 1 field. | Field | In | Type | Required | Description | | ------- | ----- | ------- | -------- | ----------------------------------------------------------------- | | `limit` | query | integer | — | Limit caps the hunter and award rows returned, clamped to 1..100. | ## Response | Status | Body | Meaning | | --------- | ----------------------- | ------- | | `200` | leaderboard.BountyBoard | ok | | `default` | problem-details | refused | `200` body — 35 fields. | Field | In | Type | Always | Description | | ------------------------------ | ---- | ------------------------------ | ------ | ---------------------------------------------------------------------------------------------- | | `hunters` | body | leaderboard.BountyHunter\[] | — | Hunters are the top-ranked bug hunters and bounty contributors, best first. | | `hunters[].badge` | body | string | — | Badge is the gamified tier title earned by the contributor. | | `hunters[].bountiesMerged` | body | integer (int64) | — | BountiesMerged is how many bounty pull requests this contributor has landed. | | `hunters[].bountyPoints` | body | integer (int64) | — | BountyPoints is the sum of points earned from bug reports and bounties. | | `hunters[].bugsReported` | body | integer (int64) | — | BugsReported is how many verified bug reports this contributor has filed. | | `hunters[].creditsEarnedCents` | body | integer (int64) | — | CreditsEarnedCents is the total AI credits in US cents granted for bounties and bug reports. | | `hunters[].globalTokenRank` | body | integer (int64) | — | GlobalTokenRank is the contributor's global organization rank by token volume (0 if unranked). | | `hunters[].handle` | body | string | — | Handle is the contributor's public display handle. | | `hunters[].org` | body | string | — | Org is the contributor's organization slug when listed. | | `hunters[].rank` | body | integer (int64) | — | Rank is the contributor's 1-based standing on the bounty board. | | `hunters[].self` | body | boolean | — | Self marks the signed-in caller's own row. | | `hunters[].tokensUsed` | body | integer (int64) | — | TokensUsed is the contributor's all-time token volume in the warehouse. | | `hunters[].totalScore` | body | integer (int64) | — | TotalScore is the org's points by client.Points, the one score every board shares. | | `recentAwards` | body | leaderboard.BountyAwardView\[] | — | RecentAwards are the newest verified bug reports and bounty payouts. | | `recentAwards[].createdAt` | body | integer (int64) | — | CreatedAt is the unix timestamp (seconds) when the award was recorded. | | `recentAwards[].creditsCents` | body | integer (int64) | — | CreditsCents is the AI credit grant in US cents awarded with this bounty. | | `recentAwards[].handle` | body | string | — | Handle is the recipient's display name. | | `recentAwards[].id` | body | string | — | ID is the unique award identifier. | | `recentAwards[].kind` | body | string | — | Kind is bug\_report or bounty. | | `recentAwards[].points` | body | integer (int64) | — | Points is the leaderboard points awarded. | | `recentAwards[].summary` | body | string | — | Summary describes what was reported or fixed. | | `recentAwards[].target` | body | string | — | Target is the repository or issue reference (e.g. hanzo-inc/cloud#index-lock). | | `self` | body | leaderboard.BountyHunter | — | | | `self.badge` | body | string | — | Badge is the gamified tier title earned by the contributor. | | `self.bountiesMerged` | body | integer (int64) | — | BountiesMerged is how many bounty pull requests this contributor has landed. | | `self.bountyPoints` | body | integer (int64) | — | BountyPoints is the sum of points earned from bug reports and bounties. | | `self.bugsReported` | body | integer (int64) | — | BugsReported is how many verified bug reports this contributor has filed. | | `self.creditsEarnedCents` | body | integer (int64) | — | CreditsEarnedCents is the total AI credits in US cents granted for bounties and bug reports. | | `self.globalTokenRank` | body | integer (int64) | — | GlobalTokenRank is the contributor's global organization rank by token volume (0 if unranked). | | `self.handle` | body | string | — | Handle is the contributor's public display handle. | | `self.org` | body | string | — | Org is the contributor's organization slug when listed. | | `self.rank` | body | integer (int64) | — | Rank is the contributor's 1-based standing on the bounty board. | | `self.self` | body | boolean | — | Self marks the signed-in caller's own row. | | `self.tokensUsed` | body | integer (int64) | — | TokensUsed is the contributor's all-time token volume in the warehouse. | | `self.totalScore` | body | integer (int64) | — | TotalScore is the org's points by client.Points, the one score every board shares. | Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors). ## Examples **CLI** ```bash hanzo leaderboard bounty ``` **SDK** **.ts** ```ts import { Configuration, LeaderboardApi } from 'hanzoai'; const api = new LeaderboardApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.getLeaderboardBounty(); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import LeaderboardApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = LeaderboardApi(client).get_leaderboard_bounty() ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.LeaderboardAPI.GetLeaderboardBounty(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, leaderboard_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = leaderboard_api::get_leaderboard_bounty(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.LeaderboardApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new LeaderboardApi(client).getLeaderboardBounty(); ``` The method above is the one at the current release of the document. `hanzoai@8.5.914` (npm) and `hanzoai@8.5.914` (PyPI) were generated from an earlier release, where this operation carried a different id, so it spells the method differently — regenerating the clients is what makes the two agree. [SDKs →](https://docs.hanzo.ai/docs/sdks) **HTTP** ```bash curl https://api.hanzo.ai/v1/leaderboard/bounty \ -H "Authorization: Bearer $HANZO_API_KEY" ``` **MCP** Tool `leaderboard`, op `get_leaderboard_bounty` — POST the JSON-RPC envelope to `https://api.hanzo.ai/v1/mcp`. ```bash curl -X POST https://api.hanzo.ai/v1/mcp \ -H "Authorization: Bearer $HANZO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "leaderboard", "arguments": { "op": "get_leaderboard_bounty", "input": {} } } }' ``` --- [Leaderboard API](https://docs.hanzo.ai/docs/openapi/leaderboard) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)