ccusage / data-loader / loadSessionUsageById

Function: loadSessionUsageById()

function loadSessionUsageById(sessionId, options?): Promise<
  | null
  | {
  totalCost: number;
  entries: object[];
}>;

Load usage data for a specific session by sessionId Searches for a JSONL file named {sessionId}.jsonl in all Claude project directories

Parameters

Parameter	Type	Description
sessionId	string	The session ID to load data for (matches the JSONL filename)
options?	{ mode?: "auto" | "calculate" | "display"; offline?: boolean; }	Options for loading data
options.mode?	"auto" | "calculate" | "display"	Cost calculation mode (auto, calculate, display)
options.offline?	boolean	Whether to use offline pricing data

Returns

Promise< | null | { totalCost: number; entries: object[]; }>

Usage data for the specific session or null if not found