---
title: Get Usage Report
description: Retrieves detailed usage events for the authenticated user or team, including costs, event types, models used, and metadata. Shows the same data as displayed in the usage dashboard. Can be filtered by chatId to show usage for a specific chat, or by userId to show usage for a specific user.
docs_index: /docs/llms.txt
lastUpdated: 2026-10-02
product: v0 API
type: reference
prerequisites:
  - /docs/api/v1/quickstart
---

> For an index of all documentation, see [/docs/llms.txt](/docs/llms.txt).

#### `GET /reports/usage`

## Rate limit

This endpoint allows 60 requests per minute per user or team scope. Requests over the limit return a `429 Too Many Requests` response.

## Usage

## API Signature

### Request

#### Query Parameters

### Response

---

For a semantic overview of all documentation, see [/docs/sitemap.md](/docs/sitemap.md)

For an index of all available documentation, see [/docs/llms.txt](/docs/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/docs/agents.md](/docs/agents.md)