modl.gg

Get Player Reports

Retrieve all reports filed against a specific player.

GET /v1/minecraft/players/{uuid}/reports

Retrieve all reports that have been filed against a specific player. Results are limited to a maximum of 50 reports, ordered by the database's default sort.

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 reported player's Minecraft UUID.

Response

200 OK

{
  "status": 200,
  "reports": [
    {
      "id": "ticket789",
      "type": "REPORT",
      "reporterName": "WitnessPlayer",
      "reporterUuid": "7b2f9400-e29b-41d4-a716-446655440002",
      "subject": "Fly hacking in SkyWars",
      "status": "OPEN",
      "priority": "HIGH",
      "createdAt": "2024-01-14T16:30:00.000Z"
    },
    {
      "id": "ticket790",
      "type": "REPORT",
      "reporterName": "AnotherPlayer",
      "reporterUuid": "8c3g0500-f30c-52e5-b827-557766551003",
      "subject": "Inappropriate language",
      "status": "RESOLVED",
      "priority": "MEDIUM",
      "createdAt": "2024-01-10T12:00:00.000Z"
    }
  ]
}

Response Fields

FieldTypeDescription
reportsarrayList of reports filed against the player (max 50).
reports[].idstringThe report/ticket ID.
reports[].typestringThe ticket type (e.g., REPORT).
reports[].reporterNamestringUsername of the player who filed the report.
reports[].reporterUuidstringUUID of the player who filed the report.
reports[].subjectstringThe report subject or description.
reports[].statusstringCurrent report status (e.g., OPEN, RESOLVED, CLOSED).
reports[].prioritystringReport priority level (e.g., LOW, MEDIUM, HIGH).
reports[].createdAtstringISO 8601 timestamp of when the report was created.

Error Responses

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

On this page