Server

List server samples

Every server check ever made, one per minute.

GET/v1/server/samples

The raw series behind every server chart, oldest first. Each sample is one check: players online, capacity, response time and version, or null values when the server did not answer. Up to 5,000 samples per page, which is about 3.5 days.

Authentication

API key with the read scope

Cached for

30 s

Data updates

A new sample every minute. Kept forever.

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

Response200OK

{
  "limit": 3,
  "next": "MTc5MTUwNTEwNzAxNC4w",
  "entries": [
    {
      "t": 1791504986945,
      "online": 26914,
      "capacity": 50000,
      "latencyMs": 310,
      "version": "Velocity 1.7.2-26.3"
    },
    {
      "t": 1791505047013,
      "online": 26952,
      "capacity": 50000,
      "latencyMs": 963,
      "version": "Velocity 1.7.2-26.3"
    },
    {
      "t": 1791505107014,
      "online": 26950,
      "capacity": 50000,
      "latencyMs": 864,
      "version": "Velocity 1.7.2-26.3"
    }
  ]
}

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 1000
Entries per page.
1 to 5,000
cursorstringoptional
The next value from the previous response. Leave it out for the first page. See cursors.

Response

A feed of samples, oldest first. from and to apply to t.

limitinteger
Entries per page.
nextstring | null
Pass this as cursor to get the next page. null on the last page.
entriesServerSample[]
The entries on this page, oldest first.
ShowHide5 child fields
- ttimestamp
  When the server was checked.
- onlineinteger | null
  Players online. null when the server did not answer.
- capacityinteger | null
  Player slots the server reported.
- latencyMsinteger | null
  Response time in milliseconds.
- versionstring | null
  Version string the server reported.

Status codes

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