Skip to content

Get Server

Fetch a single server by ID.

  • Method: GET
  • Path (REST): /server/{serverId}
  • Returns: GameServer
  • Backend behavior: Returns an enriched server view (ports, IPs, limits). Requires access to the team.
GameServer srv = gmc.serverClient().getGameServer("srv-123").execute();
const srv = await gmc.serverClient.getGameServer('srv-123');
srv = gmc.server_client.get_game_server('srv-123')
curl -s -H "Application-Token: $GMC_APP_TOKEN" \
  https://api.gamemanager.cloud/server/srv-123

Response

Example:

{
  "id": "srv-123",
  "displayName": "Public #1",
  "nodeId": "node-123",
  "created": "2025-01-01T12:00:00Z",
  "gameType": "ARK_ASCENDED",
  "state": "RUNNING",
  "settingProfileId": "prof-1",
  "serverDirectory": "/servers/ark",
  "onlinePlayers": 12,
  "backups": [
    {
      "backupId": "bck-1",
      "serverId": "srv-123",
      "createdAt": "2025-01-01T08:00:00Z",
      "expiresAt": "2025-02-01T08:00:00Z",
      "autoBackup": false,
      "name": "pre-update",
      "size": 104857600
    }
  ],
  "commands": [
    {
      "command": "Broadcast Hello",
      "response": "Message sent",
      "timestamp": "2025-01-01T12:00:00Z"
    }
  ],
  "nodeName": "eu-west-1",
  "serverIp": "203.0.113.12",
  "map": "Fjordur",
  "maxPlayers": 64,
  "modCount": 0,
  "serverPort": 27015,
  "queryPort": 27016,
  "rconPort": 27017
}

Responses

  • 200 OK: Server returned.
  • 403 Forbidden: missingPermission.ACCESS_SERVERS — you lack read access in this team.
  • 404 Not Found: general.not_found — server/node/team not found.
  • 400 Bad Request: server.unsupported_game_type — unknown or unsupported game type for this server.
  • 500 Internal Server Error: server.dto_mapping_profile_not_found — server’s setting profile is missing.