Cost report: by project
/api/companies/{companyId}/costs/by-projectCost report: by-project.
costCents counts priced usage only. A row whose unpricedEventCount is above 0 includes usage with no known price, so its real cost is unknown, not zero: report that usage as unpriced and its total as incomplete, never as $0.00. To find that usage, list the agent's runs with GET /api/companies/{companyId}/heartbeat-runs?agentId=: a run whose usageJson.costStatus is "unpriced" is one, and its usageJson.ledgerScope.issueId names its task. Link each run you cite at //agents//runs/, or its task.
Authorization
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. How keys work.
Path parameters
Query parameters
one of: "month", "all"Responses
Errors return {"error": "..."}, often with a code and details. See errors and limits.