VOTING API

Verify your players' votes in real-time and automate your in-game rewards.

01. Introduction

The McServ API allows server administrators to check if a user has voted during the current calendar day. Votes are reset every day at 00:00 (UTC).

Unlike Votifier notifications, which can be missed if your server is offline, the API allows for on-demand verification when a player logs in.

Check votes on your web store to apply discounts or unlock purchases without the player needing to be connected in-game.

Display a dynamic reminder on your site or launcher to show players if they have already supported the server today.

The slug is the permanent text identifier found in your server's URL. It is more stable than the numeric ID and makes script maintenance easier.

mcserv.org/servers/slug_de_votre_serveur

→ Identifier to extract from your McServ public URL.

GET slug/IP

Response text/plain : 1 (voted) or 0 (no vote).

GET slug/IP/json

Detailed JSON response including timestamp and the midnight reset.

RESPONSE_PREVIEW:

{
  "vote": "1",
  "voted_at": "2026-02-05T14:20:01Z",
  "reset": true,
  "next_in": 34799
}