API Documentation

Introduction

This API allows you to retrieve server data programmatically. All endpoints return JSON responses and require no authentication.

Base URL:

https://lista-minecraft.pl

Response Format:

application/json

Authentication:

No authentication required

Available Endpoints

Get Server Votes

GET /api/servers/{uuid}/votes

Retrieves a list of votes for a specific server from the last 7 days. Returns anonymized voting data including voter nicknames and voting timestamps.

Parameters

Name	Type	Required	Description
`uuid`	string	Required	Unique identifier (UUID) of the server

Request Example

cURL

curl -X GET 'https://lista-minecraft.pl/api/servers/your-server-uuid/votes' \
  -H 'Accept: application/json'

Response Example

JSON

[
  {
    "nickname": "HeVer_",
    "createdAt": "2025-11-07T19:04:55+01:00"
  },
  {
    "nickname": "PlayerName",
    "createdAt": "2025-11-07T18:30:12+01:00"
  }
]

Response Fields

Field	Type	Description
`nickname`	string	Nickname of the voter (from the voting form)
`createdAt`	string	Timestamp when the vote was cast (ISO 8601 format with timezone)

Response Codes

Code	Description
200	Success - Returns array of votes
404	Server not found