v64

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

Get end-user profile

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}

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

errorsOnly'true' | 'false'

When true, scope every aggregate to errored traces only.

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.