The session's billed usage, newest first [read]

Changed on

Totals plus one row per billed event — model turns, runtime, capability and connector calls — with the token breakdown, list and billed dollars, basis and duration. limit (default 50) pages with an opaque cursor; keep following cursor until it is null. A row whose coveredBy is subscription ran on the reader's own Claude or ChatGPT plan: listCostUsd is what it was worth, billedCostUsd is zero. Dollar amounts here are numbers in USD, not the {amount, currency} cents object used elsewhere.

get/sessions/{id}/usage

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/sessions/{id}/usage
  • Auth
    HTTP bearer

Path parameters

idstring required

The session id

Query parameters

cursorstring

A cursor from a previous page

limitinteger

1–500, default 50

Response

OK

sessionstring required

The session's public id (sess_…)

budgetobject nullable

The session's budget summary — the same shape as budget on Session — or null when it has none

cursorstring nullable required

Pass as ?cursor= for the next page; null on the last

Changes

    • info

      added the optional property / to the response with the status

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status