---
title: "Get Usage Report"
method: GET
path: "/reports/usage"
tags: ["reports"]
---

# Get Usage Report

`GET /reports/usage`

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.

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `chatId` string
- `messageId` string
- `limit` number
- `cursor` string — Base64 encoded cursor containing pagination data

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` object[], required
    - `id` string, required
    - `object` 'usage_event', required
    - `type` 'image_generation' | 'message' | 'manual_debit' | 'api_request' | 'inline-edit'
    - `promptCost` string
    - `completionCost` string
    - `totalCost` string, required
    - `chatId` string
    - `messageId` string
    - `userId` string
  - `pagination` object, required
    - `hasMore` boolean, required
    - `nextCursor` string
    - `nextUrl` string
  - `meta` object, required
    - `totalCount` number, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-09-23** `901cfbcf3419` — 1 info
  - endpoint added
- **2025-08-24** `3521652a43a7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/reports/usage/get.md)

---

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