---
title: "report.ai_usage.read · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/report.ai_usage.read"
updated: null
---

# report.ai\_usage.read · OpenVibe.Services

HTML: [report.ai\_usage.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/report.ai_usage.read)

# `report.ai_usage.read`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, internal).

Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid\_by). The public totals (GET /api/v1/ai/usage/open) need no token at all.

- Owner: report (token audience `openvibe.report`)
- Version: 1.0
- Status: active
- Visibility: internal
- Resource constraints: none
- Quota class: report-read
- Permissions: report:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: report.ai-usage-result@1
- Events: —
- Implemented by: - `GET /api/v1/ai/usage`

[These routes in the API explorer](/docs/api/report#cap-report.ai_usage.read)