modl.gg

List Reports

Retrieve reports with optional status filter.

GET /v1/minecraft/reports

Retrieve a list of reports with optional filtering by status. Results are returned in reverse chronological order.

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.

Query Parameters

ParameterTypeRequiredDescription
statusstringNoFilter by report status. Default: open.
limitintegerNoMaximum number of reports to return. Default: 50, max: 100.
GET /v1/minecraft/reports?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"
    }
  ]
}

Error Responses

Status CodeDescription
400Invalid query parameters.
401Missing or invalid API key.
429Rate limit exceeded.
500Internal server error.

On this page