v31

latestOpenAPI 3.1.2raw.githubusercontent.com2026-08-074420793.1 KB
Usage

List Usage Events

Lists individual credit usage events. Each event includes the credits charged and, when available, associated token counts.

get/usage/events

Query parameters

startstring date-time

Inclusive ISO 8601 start timestamp. Defaults to seven days ago.

endstring date-time

Exclusive ISO 8601 end timestamp. Defaults to the current time.

userIdstring

Filter usage by user. Team owners and billing members may select any team member; other callers may select only themselves.

chatIdstring

Filter usage by chat identifier.

messageIdstring

Filter usage by message identifier.

limitinteger

Maximum billing records considered per credit source (1-100, default 50). Related records may be combined into one event.

cursorstring

Opaque cursor returned by the previous page. It preserves the prior range and filters, so other query parameters may be omitted on subsequent pages.

Response

Response for status 200

object'list' required

Object type identifier.