modl.gg
Developer API

Get Chat Logs

Retrieve a player's chat log history.

GET /v1/minecraft/players/{uuid}/chat-logs

Retrieve chat log entries for a specific player, ordered by most recent.

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

Query Parameters

ParameterTypeRequiredDescription
limitintegerNoThe maximum number of entries to return (min: 1, max: 500). Defaults to 200.

Example

GET /v1/minecraft/players/550e8400-e29b-41d4-a716-446655440000/chat-logs?limit=100

Response

200 OK

{
  "entries": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "username": "Notch",
      "message": "Hello world!",
      "timestamp": 1699000000000,
      "server": "survival-1"
    }
  ]
}

Error Responses

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

On this page