API Documentation

Public REST API

Base URL: https://palserves.online

GET /api/servers

Get a list of all approved servers with optional filters.

curl https://palserves.online/api/servers?game_mode=pve&status=online&language=de&sort=votes

Parameters: game_mode, status, language, country, search, sort (votes/newest/alphabetical/players), limit, offset

GET /api/server/:id/status

Check a server's live status via REST API or RCON.

curl https://palserves.online/api/server/1/status
POST /api/vote

Vote for a server. Requires server_id and optionally api_key (user API key from dashboard).

curl -X POST https://palserves.online/api/vote \
  -H "Content-Type: application/json" \
  -d '{"server_id": 1, "api_key": "YOUR_API_KEY"}'
GET /api/countries

Returns all supported countries with ISO codes and flags.

curl https://palserves.online/api/countries
GET /api/languages

Returns all supported server languages with ISO codes.

curl https://palserves.online/api/languages
Vote API

The Vote API is integrated directly into the main application. No separate port needed.

POST /api/vote

Vote for a server. Requires server_id and optionally api_key.

curl -X POST https://palserves.online/api/vote \
  -H "Content-Type: application/json" \
  -d '{"server_id": 1, "api_key": "YOUR_API_KEY"}'
GET /api/server/:id

Get server info including vote count.

curl https://palserves.online/api/server/1
Authentication

API keys are generated automatically when a user registers. Find your API key in the Dashboard.

For the Vote API, pass your API key in the JSON body:

{
  "server_id": 1,
  "api_key": "a1b2c3d4e5f6..."
}
Vote via Discord Bot!

The Discord bot lets you vote and browse servers directly from Discord. Add the bot to your server using the invite button on the homepage.

/vote <server>

Vote for a server by name or ID. One vote per Discord user per day.

/vote My Palworld Server
/servers

List all approved servers with vote counts and online status.

/servers
/server <server>

Show detailed info about a specific server including IP, players, game mode, and a link to vote on the website.

/server My Palworld Server
/top

Show the top 10 servers ranked by votes.

/top
/link <api_key>

Link your Discord account to your palserves.online account. Find your API key in the Dashboard.

/link a1b2c3d4e5f6...
/help

Show all available bot commands.

/help
Invite Bot