Bounties

List bounty history

Every bounty that was claimed or removed.

GET/v1/bounties/history

The complete record of closed bounties, newest first. A bounty closes when it is claimed or taken down, so a large bounty that closed soon after it appeared usually means someone collected it.

Authentication

API key with the read scope

Cached for

30 s

Data updates

Every 15 minutes. Kept forever.

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

Response200OK

{
  "limit": 2,
  "next": "MTc5MjcyNTQyMzI3Mi40NTgxNjI",
  "entries": [
    {
      "username": "TheoTheGreat26",
      "uuid": "092bf6df-4d3c-4a4b-bc07-3a3bad991ad8",
      "amount": 474,
      "since": 1792722539054,
      "closedAt": 1792725423272
    },
    {
      "username": ".IIf3risII",
      "uuid": "00000000-0000-0000-0009-01f0f199db4c",
      "amount": 958,
      "since": 1792722539054,
      "closedAt": 1792725423272
    }
  ]
}

Try itCounts towards your plan

Query parameters

fromtimestampoptional
Only entries at or after this time, in Unix milliseconds.
totimestampoptional
Only entries before this time, in Unix milliseconds.
limitintegeroptionaldefault 100
Entries per page.
1 to 1,000
cursorstringoptional
The next value from the previous response. Leave it out for the first page. See cursors.

Response

A feed of closed bounties, newest first. from and to apply to closedAt.

limitinteger
Entries per page.
nextstring | null
Pass this as cursor to get the next page. null on the last page.
entriesobject[]
The entries on this page, newest first.
ShowHide5 child fields
- usernamestring
  The target.
- uuidstring | null
  Minecraft UUID, once known.
- amountnumber
  The bounty when it closed.
- sincetimestamp
  When the bounty first appeared.
- closedAttimestamp
  When the bounty closed.

Status codes

Status	When
400Bad Request	A malformed window or `cursor`.