Background f9585740658922027ac082c24fc997b33b8b9a8d42199f418052ff6577b9134f

API Documentation

API Documentation


By using our the Minecraft-Servers-List.net API you can ask us for specific data in an automated fashion.

API Endpoints

Checking wether someone has voted or not is an extremely handy feature. It can for example be used in vote verification plugins so you can reward your players after they have voted.
GEThttp://minecraft-servers-list.net/api/votes/check/YOUR_SERVER_API_KEY_HERE/USERNAME_OF_VOTER/
ParameterDescriptionData Type
keyYour Server API KeyString
usernameVoter's usernameString

ResponseDescription
{ "voted" : false, "claimed" : false }Not found
{ "voted" : true, "claimed" : false }Has voted and not claimed
{ "voted" : true, "claimed" : true }Has voted and claimed
This feature allows you to set someone's voted as claimed, this way they cannot claim the same reward twice.
POST http://minecraft-servers-list.net/api/votes/claim/YOUR_API_KEY_HERE/USERNAME_OF_VOTER/
ParameterDescriptionData Type
keyYour Server API KeyString
usernameVoter's usernameString

ResponseDescription
{ "voted" : false, "claimed" : false }We were unable to locate the user's vote based on the information provided.
{ "voted" : true, "claimed" : true }This vote has been marked as claimed

API Plugins

Votifieris a reward plugin for Minecraft Servers. Using this plugin you can give rewards to players that voted for your server on Minecraft-Servers-List.net

Detail & Download

If you're simply trying to do vote verification for your server, we advise against directly using this API. Simply download the vote plugin above, and download your configuration file from your my servers page for a drag and drop experience.