Plans
All plans reach the same routes. They differ in call quota, rate limit and how far back the history goes.
Free
For trying it out and small personal projects.
- 25,000 calls per month
- 20 calls per minute
- History up to 24 hours back
- All current routes
Developer
For bots, trackers and tools with real users.
- 250,000 calls per month
- 60 calls per minute
- History up to 7 days back
- All current routes
Pro
For dashboards and services that poll often.
- 2,000,000 calls per month
- 300 calls per minute
- History up to 30 days back
- Player trackers
Side by side
Same numbers, one table. Still provisional.
| Limit | Free | Developer | Pro |
|---|---|---|---|
| Calls per month | 25,000 | 250,000 | 2,000,000 |
| Calls per minute | 20 | 60 | 300 |
| History window | 24 hours | 7 days | 30 days |
| Player trackers | No | No | Yes |
| Data refresh | Every 5 minutes | Every 5 minutes | Every 5 minutes |
| Price per month | $0 | $5 | $15 |
Questions
What counts as a call?
One HTTP request to any route is one call, whatever the size of the response. /v1/status is never counted.
What happens when I hit my limit?
The API answers with status 429 until the limit resets. A minute limit comes with a retry-after header that tells you how long to wait. Every response carries headers with what you have left.
Is this the official DonutSMP API?
No. DonutSMP disabled its official API in 2026. API keys were first restricted to ranked players on July 3, 2026, then DonutSMP staff announced on September 29, 2026 that it was fully disabled, for abuse and safety reasons. In the game, the /api command now answers that the API has been disabled. Donut API is an independent, unofficial replacement that provides the same kind of data through bots in the game.
How do I get a key?
Open the dashboard, type your Minecraft username and make the small payment it gives you in the game, to a player picked at random. Once signed in, you can create a free key. There is no password, and the email is optional. Paid plans cannot be bought yet, and you can still call the API without a key, within the keyless limits above.