Real players over time

GET/v1/servers/{address}/history

Real players over time, one point an hour from LobbyVerse’s checks, oldest first.

Path parameters

addressstring · required

Address of existing server.

addressstring · required

The server's address, ip:port

Query parameters

rangestring

24h (the default), 7d or 30d

Response

200 Points in time. The answer is { "data": … }; data is HistoryPoint[].

HistoryPoint

atstring

playersinteger | null

Real players then; null when the server didn't answer

Errors

Errors are problem details with a detail written to be shown to people.

Status	When
`400`	A parameter isn’t valid
`401`	No API key, or one that isn’t valid or was revoked
`404`	Nothing there
`429`	Over a rate limit (60 a minute, 10000 a day per key); see Retry-After
`503`	History or rankings are briefly unavailable

curl "https://api.lobbyverse.com/v1/servers/163.182.12.174:27015/history?range=24h" \
  -H "Authorization: Bearer $LOBBYVERSE_KEY"

const response = await fetch("https://api.lobbyverse.com/v1/servers/163.182.12.174:27015/history?range=24h", {
  headers: { Authorization: `Bearer ${process.env.LOBBYVERSE_KEY}` },
});
const { data } = await response.json();

import os, requests

response = requests.get(
    "https://api.lobbyverse.com/v1/servers/163.182.12.174:27015/history?range=24h",
    headers={"Authorization": f"Bearer {os.environ['LOBBYVERSE_KEY']}"},
)
data = response.json()["data"]

require "net/http"
require "json"

uri = URI("https://api.lobbyverse.com/v1/servers/163.182.12.174:27015/history?range=24h")
request = Net::HTTP::Get.new(uri, "Authorization" => "Bearer #{ENV.fetch("LOBBYVERSE_KEY")}")
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { it.request(request) }
data = JSON.parse(response.body)["data"]

200 · live sample, 1 min ago at build34 ms

{
  "data": [
    {
      "at": "2026-11-01T14:16:01Z",
      "players": 0
    },
    {
      "at": "2026-11-01T15:19:53Z",
      "players": 0
    }
  ],
  "meta": {
    "range": "24h",
    "total": 25
  }
}