Models and accounts

Usage

What has been spent, grouped

One read: the spending record over a range of days, grouped finely enough that every cost screen is a rearrangement of it rather than a second call.

GET/usage/rollupWhat was spent, grouped

The spending record over a range of days, grouped by day, provider, account and model. Everything a cost screen shows is a rearrangement of this one answer, so nothing needs a second call. Read-only: rows are written by the sandbox as turns end, which is what makes it worth trusting.

What you send

Field	Type	Where
`from`First day to include, as YYYY-MM-DD…	string	query
`to`Last day to include, as YYYY-MM-DD…	string	query

What comes back

Field	Type
`rows`Spending grouped by day, provider, account,…	object[]
`day`The day, as YYYY-MM-DD in UTC	string
`provider`Which model provider	string
`account`Which account	string
`model`Which model	string
`harness`Which agentic loop	string
`conversationId`Which conversation	string
`turns`Turns in this group	number
`inputTokens`Tokens sent	number
`outputTokens`Tokens received	number
`cacheReadTokens`Tokens served from cache	number
`cacheCreationTokens`Tokens written to cache	number
`costUsd`What the group cost, in dollars	number
`durationMs`Time spent, in milliseconds	number

Try itanswered in this tab

curl

curl "$SANDBOX/usage/rollup" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.usage.rollup();