Server

Get server status

Players online now, latency, peaks and 30 days of uptime.

GET/v1/server

DonutSMP is checked every minute. history covers the window you ask for in at most about 288 points, each the average player count of its bucket. daily covers the last 30 days.

Authentication

API key with the read scope

Cached for

30 s

Data updates

Every minute.

curl "https://api.donutstats.io/v1/server?hours=1" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "online": 19551,
  "capacity": 50000,
  "latencyMs": 92,
  "version": "Velocity 1.7.2-26.3",
  "updatedAt": 1792724136015,
  "peak24h": 30510,
  "recordPeak": 46857,
  "recordPeakAt": 1791741261331,
  "history": [
    {
      "t": 1792722060000,
      "online": 21288
    },
    {
      "t": 1792722120000,
      "online": 21249
    }
  ],
  "daily": [
    {
      "t": 1791504000000,
      "uptime": 0.9739921976592978,
      "peak": 39606,
      "average": 31372
    },
    {
      "t": 1791590400000,
      "uptime": 0.9993055555555556,
      "peak": 46803,
      "average": 36714
    }
  ]
}

Try itCounts towards your plan

Query parameters

hoursintegeroptionaldefault 24
Hours of history to return.
1 to 2,160

Response

Server figures.

onlineinteger | null
Players online at the last check.
capacityinteger | null
Player slots the server reports.
latencyMsinteger | null
Response time in milliseconds.
versionstring | null
Version string the server reports.
updatedAttimestamp | null
When the server last answered.
peak24hinteger | null
Most players online in the last 24 hours.
recordPeakinteger | null
Most players online ever recorded.
recordPeakAttimestamp | null
When that record was set.
historyobject[]
Average players online per bucket, oldest first: t and online.
dailyobject[]
The last 30 days, oldest first.
ShowHide4 child fields
- ttimestamp
  Midnight UTC.
- uptimenumber | null
  Share of checks the server answered, from 0 to 1.
- peakinteger | null
  Most players online that day.
- averageinteger | null
  Average players online that day.