v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB
Users

Get end-user usage breakdown

Returns the end-user's top values of a usage dimension — model, provider, or tool — ranked by distinct trace count.

get/v1/projects/{projectSlug}/users/{userId}/usage

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

userIdstring required

End-user identifier. URL-encode values containing special characters.

End-user identifier. URL-encode values containing special characters.

Query parameters

dimension'model' | 'provider' | 'tool' required

Dimension to break the usage down by.

Dimension to break the usage down by.

limitinteger

Maximum number of values to return.

Maximum number of values to return.

errorsOnly'true' | 'false'

When true, scope every aggregate to errored traces only.

When true, scope every aggregate to errored traces only.

Response

Usage breakdown