Get Usage Report

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.

GET/v1/reports/usage

Usage

TypeScript Example

import { v0 } from 'v0-sdk'const result = await v0.reports.getUsage()console.log(result)

API Signature

Request

Query Parameters

startDate?: string

Query parameter "startDate"

endDate?: string

Query parameter "endDate"

chatId?: string

Query parameter "chatId"

messageId?: string

Query parameter "messageId"

userId?: string

Query parameter "userId"

limit?: number

Query parameter "limit"

cursor?: string

Base64 encoded cursor containing pagination data

Response

object: 'list'

data: object[]

id: string

object: 'usage_event'

promptCost?: string

completionCost?: string

totalCost: string

chatId?: string

messageId?: string

userId?: string

Deprecated - use user object instead

user?: object

createdAt: string

The ISO timestamp representing when the usage event was created.

pagination: object

hasMore: boolean

nextCursor?: string

nextUrl?: string

meta: object

totalCount: number