Public API

Use this endpoint to check when a player last voted for your server and when they will be allowed to vote again.

Endpoint

Make a simple GET request:

GET https://api.top-servers-hytale.com/api/v1/votes/<serverId>/<username>

Parameters

<serverId>The unique ID of your server on our website.
<username>The in-game name of the player.

Quota

60 requests/minute per IP

Example Request

Request

GET https://api.top-servers-hytale.com/api/v1/votes/qiGVkdcdeixVR7hWwW4P9K/jhonDoe

Response

{
  "lastVoteAt":1768296330,
  "nextVoteAt":1768299930,
  "canVote":true,
  "totalVotes":42
}

Timestamps are returned as Unix timestamps in seconds.

Usage Idea

You can call this endpoint from your plugin or script to check if a player is allowed to vote reward again. If the current time is ≥ nextVoteAt, the player can vote and receive a reward.