reports

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/reports/usage

Query parameters

startDatestring date-time

Query parameter "startDate"

endDatestring date-time

Query parameter "endDate"

chatIdstring

Query parameter "chatId"

messageIdstring

Query parameter "messageId"

userIdstring

Query parameter "userId"

limitnumber

Query parameter "limit"

cursorstring

Base64 encoded cursor containing pagination data

Base64 encoded cursor containing pagination data

Response

Success

object'list' required

Changes