Docs Menu

Get Server

Endpoint

GET /api/v1/servers/{ip}/{port}

Path parameters

  • ip server IP address
  • port server port

Example

curl -X GET "https://slowstack.tv/api/v1/servers/119.199.192.32/25565" 
  -H "Authorization: Bearer YOUR_API_KEY"

Code examples

const response = await fetch('https://slowstack.tv/api/v1/servers/119.199.192.32/25565', {
  headers: { Authorization: 'Bearer YOUR_API_KEY' }
});

if (!response.ok) throw new Error(`Request failed: ${response.status}`);

const { data } = await response.json();
console.log(data.ipAddress, data.port, data.versionName);

Response

{
  "data": {
    "ipAddress": 2009579552,
    "port": 25565,
    "versionName": "Purpur 1.21.11",
    "versionProtocol": 774,
    "descriptionText": "소망 서버",
    "descriptionExtra": "",
    "maxPlayers": 20,
    "onlinePlayers": 0,
    "faviconHash": null,
    "enforcesSecureChat": false,
    "previewsChat": false,
    "countryCode": "KR",
    "hostnames": ["ptr.example.net"],
    "onlineMode": true,
    "whitelisted": false,
    "createdAt": "2026-01-06T21:54:55.076Z",
    "updatedAt": "2026-02-21T10:01:13.289Z",
    "favicon": "https://.../default.png"
  }
}

ipAddress is a signed 32-bit integer. See IP Address Integer Format for conversion examples in JavaScript, Python, and Java.

hostnames contains public reverse-DNS PTR names for the server IP. It is empty when no PTR record is known and may differ from the address players use to connect.