Events

The client.events resource lets you query the event log for personal, faction, inventory, and combat events.

The Events endpoint uses 0-based indexing (start_index: 0) unlike all other endpoints which use 1-based indexing.

events.get()

Get a specific event by UID. Returns the Event object directly — not wrapped in a Page.

string

required

The uid parameter.

const event = await client.events.get({ uid: '5:99001' });
console.log(event.type); // access properties directly, not event.data

events.list()

List events by type and mode (paginated) Note: This endpoint uses 0-based indexing (unlike most other endpoints which use 1-based). The API reports no total for events, so page.total is always 0; hasMore is true when a full page came back.

string

required

Event mode: ‘personal’, ‘faction’, ‘inventory’, or ‘combat’

string

Event type filter (optional, only for personal/faction modes)

string

Faction ID for faction mode

number

default:"50"

Number of items to retrieve. Default: 50, Max: 1000

number

Milliseconds to wait before fetching each subsequent page. Helps avoid rate limits during auto-pagination.

number

default:"0"

Starting position (0-based). Default: 0

number

Unix timestamp to filter events after this time

const events = await client.events.list({ eventMode: 'personal' });
const moreEvents = await client.events.list({ eventMode: 'personal', start_index: 50, item_count: 100 });
const recentEvents = await client.events.list({ eventMode: 'personal', start_time: 1640000000 });
const factionEvents = await client.events.list({ eventMode: 'faction', faction_id: '20:123' });
// Fetch up to 1000 events at once
const manyEvents = await client.events.list({ eventMode: 'personal', item_count: 1000 });

Character

Access the character whose events you are querying.

Faction

Access faction details for faction events.

Get Started

Authentication

Core Concepts

API Resources

events.get()

events.list()

Character

Faction

​events.get()

​events.list()

​Related resources

Character

Faction

events.get()

events.list()

Related resources