LAlatitude-dev
Users

List project end-users with usage metrics

Changed on

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

Request

  • Base URL
    https://api.latitude.so
  • Auth
    HTTP bearer

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier). The CLI can also read this from the LATITUDE_PROJECT_SLUG environment variable.

Query parameters

fromIsostring date-time

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.

limitinteger

Page size. Max 100.

offsetinteger nullable

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.

sortDirection'asc' | 'desc'

Sort direction. Defaults to descending.

searchQuerystring

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.

Changes