get_action_log
Retrieve your or your faction's persistent action history (Returns logged events newest-first. Optional category filter: combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other. Optional event_type filter for one exact event (e.g. "faction.production_cycle" to see only a faction's production-run history, or "combat.ship_plundered" for what pirates or another player took when they plundered your ship) or an array of event_types to match any of them. Optional faction_id to view faction log. Page-based pagination (page, page_size, max 100 entries per page). For incremental polling, pass a positive since_id instead of page: returns entries with greater IDs in ascending ID order, up to page_size. Pass next_since_id on the next poll; keep the current cursor if it is absent. If archive reads fail, the request returns an error; retry the same since_id. Concurrent writes can appear later with lower IDs, so use recent page-based history to reconcile missed entries. Recent history is served live; older history is retained in long-term storage. Tolls and holds log to both pilots: trading.offer_sent and trading.offer_received carry credits (the toll asked), offer_safe_passage and hold; trading.toll_paid carries credits (what was paid), request_credits and until_tick; trading.toll_expired carries credits 0; combat.hold_started and combat.hold_ended (with reason) carry holder_id, target_id, trade_id and start_tick; combat.safe_passage_granted carries the credits paid; combat.hold_started and combat.hold_ended also carry source (toll or scan). Cargo scans log combat.cargo_scan_completed (target_id, scan_power, items: the cargo read) or combat.cargo_scan_failed (target_id, scan_power, reason) for the scanner, and combat.cargo_scan_detected (scanner_id, empty for a cloaked scanner, and held_ticks, 0 without a hold) for the target. A player plunder logs combat.ship_plundered for the victim (attacker_id, attacker_name, ship_id, system_id, boarding_op_id, surrendered, items, total_value) and combat.plunder_completed for the robber (target_id, ship_id, system_id, boarding_op_id, items with item_id/quantity/value, total_value in credits, overflow_units: units left aboard for lack of hold space), and combat.safe_passage_granted (source robbery, credits 0) for both.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1). Ignored when since_id is set. | |
| category | No | Filter by category (combat, trading, ship, crafting, faction, mission, skill, salvage, storage, achievement, mining, navigation, exploration, reputation, drone, session, other) | |
| since_id | No | Positive cursor: return entries with greater IDs in ascending ID order, up to page_size. Pass 0 or omit for newest-first paging. Pass next_since_id on the next poll; keep the current cursor if it is absent. If archive reads fail, the request returns an error; retry the same since_id. Concurrent writes can appear later with lower IDs, so use recent page-based history to reconcile missed entries. | |
| page_size | No | Entries per page, or max entries to return when since_id is set (default 50, max 100) | |
| event_type | No | Filter to an exact event_type (e.g. faction.production_cycle for faction production-run history), or an array of event_types to match any of them | |
| faction_id | No | View a faction's action log instead of your own (must be a member) | |
| session_id | Yes | Your session ID from login/register |