Sign in

v64

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

List project end-users with usage metrics

Returns a page of the project's identified end-users over the range, each with trace, session, token, and cost metrics, plus cost aggregates across every matching user. The range defaults to the trailing 30 days.

get/v1/projects/{projectSlug}/users

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

Query parameters

fromIsostring date-time

Lower bound (inclusive) of the time range. Defaults to 30 days before toIso.

Lower bound (inclusive) of the time range. Defaults to 30 days before toIso.

toIsostring date-time

Upper bound (inclusive) of the time range. Defaults to now.

Upper bound (inclusive) of the time range. Defaults to now.

limitinteger

Page size. Max 100.

Page size. Max 100.

offsetinteger nullable

Zero-based offset of the first user to return.

Zero-based offset of the first user to return.

sortBy'lastSeen' | 'firstSeen' | 'traces' | 'sessions' | 'errors' | 'tokens' | 'cost' | 'costAvg' | 'costMedian'

Field to sort by. Defaults to most recently seen.

Field to sort by. Defaults to most recently seen.

sortDirection'asc' | 'desc'

Sort direction. Defaults to descending.

Sort direction. Defaults to descending.

searchQuerystring

Case-insensitive substring match on the user's id or email.

Case-insensitive substring match on the user's id or email.

Response

Page of end-users

totalCountinteger required

Total users matching the filters across every page.

hasMoreboolean required

true when there is at least one more page after this one.

limitinteger required

Page size used for this response.

offsetinteger required

Zero-based offset of the first item in this page.