API Reference
Log In
API Reference

List users

get
https://app.revenium.ai/api/v2/analytics/filter-options/users

Returns the subscriber email of each user with usage in the date range, in alphabetical order, in lowercase. The subscriber email is the email address sent with each call when it is metered. The date range defaults to the last 24 hours. By default this returns users with coding assistant cost only. Pass costSources to include other usage. Pass a value as users on the cost endpoints.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
date-time

Start of the date range, ISO 8601 in UTC, for example 2026-01-01T00:00:00Z. Defaults to 24 hours before endDate.

date-time

End of the date range, ISO 8601 in UTC. Defaults to now.

string
enum

Accepted for compatibility. This endpoint ignores it.

integer | null
≥ 0
Defaults to 0

Accepted for compatibility. This endpoint does not page its results and ignores it.

integer
≤ 100
Defaults to 20

Accepted for compatibility. This endpoint does not page its results and ignores it.

costSources
array of strings
Defaults to coding_assistant

Which cost to count: coding_assistant (coding assistant seats and usage), revenium_metered (usage metered by the Revenium SDK) or provider_billing (cost reported by your AI provider's billing). Defaults to coding_assistant only. Repeat the parameter to pass several values.

costSources
Allowed:
string

Hashed id of the team to answer for. Optional. With a user token it may be any team the user belongs to; without it the user's default team answers. An API key always answers for its own team, and naming any other team is refused with 403.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 1 hour ago

Did this page help you?
Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 1 hour ago

Did this page help you?