---
title: "List Session Usage"
method: GET
path: "/v1/tetra/usage"
tags: ["AgentQL Tetra (Remote Chrome Browser)"]
---

# List Session Usage

`GET /v1/tetra/usage`

List Tetra browser session usage for the authenticated user.

## Query parameters

- `sub_user_id` string, nullable
- `session_id` string, nullable
- `start_after` string, date-time, nullable
- `end_before` string, date-time, nullable
- `updated_after` string, date-time, nullable
- `updated_before` string, date-time, nullable
- `status` 'running' | 'ended'
- `sort` 'created_at_desc' | 'updated_at_asc' — Sort modes for /usage results. `created_at_desc` is the default and preserves the historical ordering. `updated_at_asc` is for incremental consumers (Mino's browser usage aggregator) that cursor by `updated_at` and need stable ascending iteration; pair with `updated_after` filtering.
- `limit` integer
- `page` integer

## Response `200`

Successful Response

- TelemetryListResponse
  - `items` TelemetryEntry[], required
    - `session_id` string, required
    - `user_id` string, nullable, required
    - `sub_user_id` string, nullable, required
    - `request_origin` string, nullable, required
    - `base_url` string, nullable, required
    - `cdp_url` string, nullable, required
    - `mode` 'light' | 'stealth' | 'tf-browser', required — Browser profile types. LIGHT provides fast headless browsing for standard automation. STEALTH provides enhanced anti-detection capabilities with full browser features TF_BROWSER provides agent-focused capabilities with full browser features.
    - `start_time` string, date-time, nullable, required
    - `end_time` string, date-time, nullable, required
    - `duration_ms` integer, nullable, required
    - `proxy_trg_rx_bytes` integer, nullable, required
    - `proxy_trg_tx_bytes` integer, nullable, required
    - `status` 'running' | 'ended', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `page` integer, required
  - `total_pages` integer, required
  - `has_more` boolean, required

## Other responses

- `4XX` — Client Error

---

[API](https://skmtc.dev/agentql/apis/agentql-api.md) · [All operations](https://skmtc.dev/agentql/apis/agentql-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentql/agentql-api/revisions/d7edf0ed4272/schema)