---
title: "Report the calling account's hourly reads by client and source"
method: GET
path: "/api/preview/user/read-usage"
tags: ["user-profile"]
---

# Report the calling account's hourly reads by client and source

`GET /api/preview/user/read-usage`

## Request

- Base URL: `https://symbol.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://symbol.chat/api/preview/user/read-usage`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-next-auth.session-token`
  - OAuth 2
    - Authorization code: `https://mcp.symbol.chat/authorize`
    - Token URL: `https://mcp.symbol.chat/token`

## Query parameters

- `window` '24h' | '7d': A preset window ending with the current hour. Do not combine with from and to.
- `from` string: First UTC hour of a custom window, such as 2026-11-09T13:00:00Z. Requires to.
- `to` string: UTC hour the custom window ends before (exclusive), at most 744 hours after from. Requires from.

## Response `200`

Successful response

- object
  - `coverage` object, required
    - `as_of` string, required
    - `producers` object[], required
      - `last_reported_at` string, required
      - `producer_id` string, required
    - `started_at` string, required
  - `hours` object[], required
    - `all` integer, required
    - `by_client` object, required
      - `bridge` object, required
        - `local` integer, required
        - `server` integer, required
      - `cli` object, required
        - `local` integer, required
        - `server` integer, required
      - `flutter` object, required
        - `local` integer, required
        - `server` integer, required
      - `hosted-mcp` object, required
        - `local` integer, required
        - `server` integer, required
      - `unknown-api` object, required
        - `local` integer, required
        - `server` integer, required
      - `web` object, required
        - `local` integer, required
        - `server` integer, required
    - `hour` string, required
    - `local` integer, required
    - `local_share` number, nullable, required
    - `measured` boolean, required
    - `server` integer, required
  - `totals` object, required
    - `all` integer, required
    - `bridge_local` integer, required
    - `by_client` object, required
      - `bridge` object, required
        - `local` integer, required
        - `server` integer, required
      - `cli` object, required
        - `local` integer, required
        - `server` integer, required
      - `flutter` object, required
        - `local` integer, required
        - `server` integer, required
      - `hosted-mcp` object, required
        - `local` integer, required
        - `server` integer, required
      - `unknown-api` object, required
        - `local` integer, required
        - `server` integer, required
      - `web` object, required
        - `local` integer, required
        - `server` integer, required
    - `local` integer, required
    - `local_share` number, nullable, required
    - `server` integer, required
  - `window` object, required
    - `current_partial_hour` string, nullable, required
    - `from` string, required
    - `to` string, required

## Changes

- **2026-11-13** `24536ef7ac40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol-chat/apis/symbol-api/changes/api/preview/user/read-usage/get.md)

---

[API](https://skmtc.dev/symbol-chat/apis/symbol-api.md) - [All operations](https://skmtc.dev/symbol-chat/apis/symbol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/symbol-chat/apis/symbol-api/revisions/3ae8310b31e1?raw)