Vote Rewards API

Integrate serverlist.gg voting into your game server using REST or Votifier. Use REST if you want full control, or Votifier for plugin-based servers.

Check Vote Status

Check whether a player has voted and if their reward is still claimable.

Endpoint
Parameter Description Required
server Your server ID Yes
key Your server API key Yes
voter SteamID64 OR Username Yes
type Action type (check) Yes
Response Values
  • 0 — Player has NOT voted
  • 1 — Vote available to claim
  • 2 — Vote already claimed

Claim Vote Reward

Mark a vote as claimed after the reward is given to the player.

Endpoint
⚠ Only call claim after you successfully give the reward. Calling it early will permanently mark the vote as used.

Helpful Information

Server ID: Found in your server URL, e.g. /server/1934-my-server → use 1934

API Key: Available in your server dashboard under API settings.

Tip: Cache check results for a few seconds on your server to reduce requests.