Join our Discord server
Click here to join our new Discord server for the Unturned community !

API Documentation

API options

To check if a Steam User or Username has voted or not in the last 24 hours.

To check if a Steam User or Username has voted or not, and if the vote has been claimed or not. This can be used for a reward plugin. The API will only check for the last 24 hours.

GET https://unturned-servers.net/api/?object=votes&element=claim&key={ServerKey}&steamid={SteamID}

GET https://unturned-servers.net/api/?object=votes&element=claim&key={ServerKey}&username={Username}

Parameter	Description	Data Type	Required
key	Your Server API Key	String	Yes
steamid	64bit SteamID of the user	Integer	Yes
username	Username of the voter	String (Case insensitive)	Yes

Response	Description
0	Not found
1	Has voted and not claimed
2	Has voted and claimed

To set a vote as claimed for a Steam User or Username.

To set a vote as claimed for a Steam User or Username. This can be used for a reward plugin. The API will only set vote as claimed in the last 24 hours.

POST https://unturned-servers.net/api/?action=post&object=votes&element=claim&key={ServerKey}&steamid={SteamID}

POST https://unturned-servers.net/api/?action=post&object=votes&element=claim&key={ServerKey}&username={Username}

Parameter	Description	Data Type	Required
key	Your Server API Key	String	Yes
steamid	64bit SteamID of the user	Integer	Yes
username	Username of the voter	String (Case insensitive)	Yes

Response	Description
0	Vote has not been claimed
1	Vote has been claimed

To get the list of voters.

To get the list of voters for your server. Limited to the top 500 results.
Output is cached for 3 minutes.

GET https://unturned-servers.net/api/?object=servers&element=voters&key={ServerKey}&month={Period}&format={Format}

Parameter	Value	Description	Data Type	Required
key	xxxxxxxx	Your Server API Key	String	Yes
month	current \| previous	Period to get	String	Yes
format	json \| xml \| html	Format of the response	String	Yes
limit	xxx	Result limit. Max value is 500. Default value is 100.	Integer	No
rank	nickname \| steamid	Rank voters by nickname or steamid. Default value is nickname	String	No

To get the list of votes.

To get the list of votes for your server. Limited to the last 500 results.
Output is cached for 3 minutes.

GET https://unturned-servers.net/api/?object=servers&element=votes&key={ServerKey}&format={Format}

Parameter	Value	Description	Data Type	Required
key	xxxxxxxx	Your Server API Key	String	Yes
format	json \| xml \| html	Format of the response	String	Yes
limit	xxx	Result limit. Max value is 500. Default value is 100.	Integer	No

To get the full detail of your server.

To get the full detail of your server in json format. Can be used to create your own status page for example.
Output is cached for 3 minutes.

GET https://unturned-servers.net/api/?object=servers&element=detail&key={ServerKey}

Parameter	Value	Description	Data Type	Required
key	xxxxxxxx	Your Server API Key	String	Yes

Plugin(s) / Service(s) Using Our API

Votifier

Votifier is a plugin of Rocket Mod for Unturned 3.x by unturned.Rocks community . Gives reward to players that voted for your server on Unturned-Servers.net.

Detail & Download

Vote Rewards

Vote Rewards is a server plugin for Unturned 2.2.5 by MiniMuleNZ . Gives reward to players that voted for your server on Unturned-Servers.net.

Detail & Download

API using SteamID works only if vote with Steam OpenID is activated on the server list. Current status: Activated