modl.gg
Developer API

Get Punishment

Get a specific punishment by its ID.

GET /v1/minecraft/punishments/{punishmentId}

Retrieve the details of a specific punishment by its ID.

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
punishmentIdstringYesThe unique ID of the punishment.

Example

GET /v1/minecraft/punishments/abc123

Response

200 OK

{
  "status": 200,
  "punishment": {
    "id": "abc123",
    "type": "Cheating",
    "category": "BAN",
    "reason": "Use of unauthorized client modifications",
    "issuerName": "StaffMember",
    "issuedAt": 1699000000000,
    "expiration": 1700000000000
  }
}

Error Responses

Status CodeDescription
401Missing or invalid API key.
404Punishment not found for the given ID.
429Rate limit exceeded.
500Internal server error.

On this page