Developer API
Get Player Reports
Retrieve all reports filed against a specific player.
GET /v1/minecraft/reports/player/{uuid}
Retrieve all reports that have been filed against a specific player, identified by their Minecraft UUID.
Authentication
Requires the X-API-Key header with your server's API key.
X-API-Key: your-api-key-hereRequest
Headers
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your server's API key. |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | string | Yes | The Minecraft UUID of the reported player. |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by report status. Default: all. |
limit | integer | No | Maximum number of reports to return. Default: 50, max: 100. |
GET /v1/minecraft/reports/player/660e8400-e29b-41d4-a716-446655440001?status=open&limit=25Response
200 OK
{
"reports": [
{
"id": "report_abc123",
"reporterUuid": "550e8400-e29b-41d4-a716-446655440000",
"reporterName": "Notch",
"reportedPlayerUuid": "660e8400-e29b-41d4-a716-446655440001",
"reportedPlayerName": "Hacker123",
"reason": "Fly hacking in survival",
"status": "open",
"assignee": null,
"createdAt": "2024-01-15T12:00:00Z",
"updatedAt": "2024-01-15T12:00:00Z"
},
{
"id": "report_def456",
"reporterUuid": "770e8400-e29b-41d4-a716-446655440002",
"reporterName": "Player2",
"reportedPlayerUuid": "660e8400-e29b-41d4-a716-446655440001",
"reportedPlayerName": "Hacker123",
"reason": "Speed hacking",
"status": "resolved",
"assignee": "StaffMember",
"createdAt": "2024-01-10T08:00:00Z",
"updatedAt": "2024-01-10T10:00:00Z"
}
]
}Error Responses
| Status Code | Description |
|---|---|
400 | Invalid UUID format or query parameters. |
401 | Missing or invalid API key. |
429 | Rate limit exceeded. |
500 | Internal server error. |