Pterodactyl API v1
Account

Account activity

Returns the activity log for the authenticated user's account

Include parameters

ParameterDescription
actorInformation about the user who performed the action
GET/api/client/account/activity

Authorization

ClientToken
AuthorizationBearer <token>

Client API key (generated at /account/api)

In: header

Query Parameters

include?string

Comma-separated list of related resources to embed. The only accepted value is actor, which adds the acting user under relationships.actor.

Value in"actor"
page?integer

Page number for pagination

per_page?integer

Results per page (max 100, default 25)

Default25
Rangevalue <= 100
filter[event]?string

Partial match on the activity event name, e.g. server:console.command

sort?string

Sort by timestamp; prefix with - for descending

Value in"timestamp" | "-timestamp"

Response Body

application/json

curl -X GET "https://pterodactyl.file.properties/api/client/account/activity?include=actor&page=1&per_page=25&filter%5Bevent%5D=server%3Apower&sort=-timestamp" \  -H "Authorization: Bearer ptlc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \  -H "Accept: application/json"
{
  "object": "list",
  "data": [
    {
      "object": "activity_log",
      "attributes": {
        "id": "c7d4d572c5422d89a66408a1facd4e06cb4f65dd",
        "batch": null,
        "event": "auth:success",
        "is_api": false,
        "ip": "82.73.127.188",
        "description": null,
        "properties": {
          "ip": "82.73.127.188",
          "useragent": "Mozilla/5.0 ..."
        },
        "has_additional_metadata": false,
        "timestamp": "2025-12-01T23:10:45+01:00",
        "relationships": {
          "actor": {
            "object": "user",
            "attributes": {
              "uuid": "1da617ee-3cdc-4651-a1c5-7cfbaf1f22dc",
              "identifier": "user_dwtbp3r43rdfdiofpt526hzc3q",
              "username": "stef",
              "email": "[email protected]",
              "image": "https://gravatar.com/avatar/bd0bc63436016cb66627527b80144c35",
              "2fa_enabled": false,
              "created_at": "2025-11-30T23:33:15+01:00"
            }
          }
        }
      }
    }
  ]
}