---
title: "List this Lucia account's supervised session usage"
method: GET
path: "/v1/account/supervised-usage"
---

# List this Lucia account's supervised session usage

`GET /v1/account/supervised-usage`

## Request

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

## Query parameters

- `status` 'active' | 'ended'
- `limit` integer
- `cursor` string

## Response `200`

Successful response

- object
  - `usage` object[], required
    - `session_id` string, required
    - `state` 'active' | 'ended', required
    - `started_at` string, date-time, required
    - `ended_at` string, date-time, nullable, required
    - `worker_milliseconds` integer, required
    - `credits_charged` number, required: Whole credits: floor(credits_charged_millicredits / 1000).
    - `credits_charged_millicredits` integer, required: Exact amount charged, in millicredits (1 credit = 1,000).
    - `closed_reason` string, nullable, required
    - `streamed_bytes` integer, required
    - `profile_bytes` integer, required
    - `active_control_milliseconds` integer, required
  - `next_cursor` string, nullable, required: Pass as cursor for the next page; null on the last page.

## Other responses

- `400`: RFC 7807 invalid-params (status or limit; errors[] per field) or invalid-cursor (restart from the first page)
- `401`: RFC 7807 account Lucia session required
- `403`: RFC 7807 owner mutation origin refused
- `404`: RFC 7807 session absent or outside the account
- `409`: RFC 7807 session ended or no longer eligible
- `410`: RFC 7807 expired or replayed admission problem
- `503`: RFC 7807 supervised session service unavailable

---

[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)