---
title: "Credits by UTC day for this Lucia account, reconciled with the ledger"
method: GET
path: "/v1/account/usage-summary"
---

# Credits by UTC day for this Lucia account, reconciled with the ledger

`GET /v1/account/usage-summary`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/usage-summary`
- Auth: API key in cookie `rove_session`

## Query parameters

- `range` '7d' | '30d' | '90d'

## Response `200`

Successful response (Cache-Control: no-store)

- object
  - `range` '7d' | '30d' | '90d', required
  - `from` string, date, required: First UTC day of the range, inclusive.
  - `to` string, date, required: Last UTC day of the range (today), inclusive.
  - `days` object[], required: One entry per UTC day, oldest first, zeros included.
    - `date` string, date, required
    - `supervised_millicredits` integer, required: Negated sum of the day's supervised worker ledger rows (charges, settlement, rounding and allocation refunds).
    - `action_millicredits` integer, required: Negated sum of the day's per-action debits (REST and stdio MCP).
    - `actions` integer, required: Metered API operations recorded that day.
  - `operations` object[], required: Operations over the range, most frequent first (REST and stdio MCP).
    - `operation_id` string, required
    - `count` integer, required
  - `supervised` object, required
    - `sessions_started` integer, required
    - `worker_milliseconds` integer, required
    - `active_control_milliseconds` integer, required
    - `millicredits` integer, required: Sum of days[].supervised_millicredits.
  - `totals` object, required
    - `millicredits` integer, required
    - `actions` integer, required

## Other responses

- `400`: RFC 7807 invalid-params: unknown range
- `401`: RFC 7807 owner-session-required: sign in
- `429`: RFC 7807 rate-limit-exceeded: 60 reads per minute per account; Retry-After
- `503`: RFC 7807 account-service-unavailable; Retry-After: 30

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)