Budget & Spend Tracking

List Spend Log End Users

The distinct end users appearing in spend logs over a time window, for the logs page filter dropdown.

Scoped like /spend/logs/ui: a proxy admin sees every end user in the window, anyone else sees only end users from their own requests or from teams they administer (or hold the /spend/logs permission on).

The window is required and the inner scan is capped at SPEND_LOGS_FACET_SCAN_CAP rows, so the query cannot degrade into a full-table scan the way /global/all_end_users does.

Example curl:

curl --location --globoff 'http://0.0.0.0:4000/management/v1/spend_logs/end_users?filter[startTime][gte]=2026-07-23T00:00:00Z&filter[startTime][lte]=2026-07-24T00:00:00Z&page_size=50&q=acme'         --header 'Authorization: Bearer sk-1234'
get/management/v1/spend_logs/end_users

Query parameters

filter[startTime][gte]string date-time required

Window start (UTC when no offset is given)

Window start (UTC when no offset is given)

filter[startTime][lte]string date-time required

Window end (UTC when no offset is given)

Window end (UTC when no offset is given)

qstring nullable

Case-insensitive partial match on the end user id

Case-insensitive partial match on the end user id

pageinteger

Page number

Page number

page_sizeinteger

Page size

Page size

Response

Successful Response

datastring[] required

Changes