modl.gg

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-here

Request

Headers

HeaderTypeRequiredDescription
X-API-KeystringYesYour server's API key.

Path Parameters

ParameterTypeRequiredDescription
uuidstringYesThe Minecraft UUID of the reported player.

Query Parameters

ParameterTypeRequiredDescription
statusstringNoFilter by report status. Default: all.
limitintegerNoMaximum number of reports to return. Default: 50, max: 100.
GET /v1/minecraft/reports/player/660e8400-e29b-41d4-a716-446655440001?status=open&limit=25

Response

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 CodeDescription
400Invalid UUID format or query parameters.
401Missing or invalid API key.
429Rate limit exceeded.
500Internal server error.

On this page