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

# Get AI Usage Report

`GET /reports/usage/ai`

Retrieves v0 AI usage events for the authenticated user or active team scope.

## Query parameters

- `start` string, date-time — Inclusive start datetime filter.
- `end` string, date-time — Exclusive end datetime filter.
- `cursor` string — Opaque cursor returned by a previous request for forward pagination.
- `limit` integer — Maximum number of rows to return.

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` object[], required
    - `eventId` string, required
    - `modelId` string, required
    - `inputTokens` number, required
    - `outputTokens` number, required
    - `totalTokens` number, required
    - `cacheCreationInputTokens` number, required
    - `cacheReadInputTokens` number, required
    - `timestamp` string, required
    - `requestId` string, required
    - `useCase` string, required
    - `chatId` string, required
    - `messageId` string, required
    - `userId` string, required
    - `userEmail` string, required
  - `pagination` object, required
    - `nextCursor` string, nullable, required
  - `dateRange` object, required
    - `start` string, nullable, required
    - `end` string, nullable, 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

- **2026-04-30** `670c302548ec` — 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/ai/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/670c302548ec/schema)