ccusage / data-loader / loadSessionUsageById

Function: loadSessionUsageById()

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

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< | { totalCost: number; entries: object[]; } | null>

Usage data for the specific session or null if not found