LAlatitude-dev
Users

Get end-user profile

Changed on

Returns the lifetime profile of one end-user — trace, session, token, cost, and activity rollups across all of the user's traces (not range-bound).

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

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.

userIdstring required

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

Query parameters

errorsOnly'true' | 'false'

When true, scope every aggregate to errored traces only.

Response

User profile

userIdstring required

The end-user's identifier, as reported on their traces' user_id.

userEmailstring required

Latest non-empty email seen on the user's traces. Empty when never reported.

firstSeenAtstring required

ISO-8601 timestamp of the user's first trace ever.

lastSeenAtstring required

ISO-8601 timestamp of the user's most recent trace ever.

traceCountinteger required

Lifetime traces attributed to the user.

sessionCountinteger required

Distinct sessions in which the user produced at least one trace.

errorSessionCountinteger required

Of sessionCount, sessions with at least one errored trace.

tokensTotalinteger required

Total tokens across the user's traces.

tokensInputinteger required

Input (prompt) tokens across the user's traces.

tokensOutputinteger required

Output (completion) tokens across the user's traces.

costTotalMicrocentsnumber required

Total cost across the user's traces, in microcents.

avgDurationNsnumber required

Mean per-trace duration, in nanoseconds.

activeDaysinteger required

Distinct UTC days with at least one trace.

Changes