Bounties

List bounties

Every open bounty, largest first.

GET/v1/bounties

Every bounty currently on the server. A bounty leaves this list once it has been claimed or removed and moves to bounty history.

Authentication

API key with the read scope

Cached for

30 s

Data updates

Every 15 minutes.

curl "https://api.donutstats.io/v1/bounties?limit=2" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "page": 1,
  "limit": 2,
  "total": 24257,
  "totalAmount": 143913569052.3,
  "updatedAt": 1792723646257,
  "entries": [
    {
      "rank": 1,
      "username": "Nibir_Goated",
      "uuid": "70775d87-cb82-4e12-81c1-d3517f596031",
      "amount": 14400000000,
      "since": 1792346822964
    },
    {
      "rank": 2,
      "username": "I8MyDogOut",
      "uuid": "a146c682-01c1-49cf-8282-33b95e059394",
      "amount": 14000000000,
      "since": 1791517431277
    }
  ]
}

Try itCounts towards your plan

Query parameters

pageintegeroptionaldefault 1
Page to return, starting at 1.
1 to 100,000
limitintegeroptionaldefault 50
Entries per page.
1 to 200

Response

A page of bounties.

pageinteger
The page you asked for, starting at 1.
limitinteger
Entries per page.
totalinteger
Entries across every page that match your filters.
updatedAttimestamp | null
When the underlying data last changed. null where it does not apply.
totalAmountnumber
Sum of every open bounty.
entriesobject[]
Bounties on this page.
ShowHide5 child fields
- rankinteger
  Position by amount, starting at 1.
- usernamestring
  The target.
- uuidstring | null
  Minecraft UUID, once known.
- amountnumber
  Bounty in DonutSMP dollars.
- sincetimestamp
  When the bounty first appeared.