---
title: "List Fleet user costs"
method: GET
path: "/v1/fleet/usage/users"
tags: ["usage"]
---

# List Fleet user costs

`GET /v1/fleet/usage/users`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/v1/fleet/usage/users`
- Auth: one of:
  - API key in header `X-API-Key` and API key in header `X-Tenant-Id`
  - HTTP bearer and API key in header `X-Tenant-Id`

Returns the same user cost report as the Fleet usage UI, grouped by recorded user email. Runs without a user email are omitted. Costs are estimates in USD from recorded traces, not invoice totals. Requires `fleet:read-admin-config`. Keep the time window and sorting unchanged across pages. Results are live: late traces or cost updates can move rows between pages; pagination does not provide a frozen snapshot.

## Query parameters

- `page_size` integer
- `cursor` string
- `start_time` string, date-time, required
- `end_time` string, date-time, required
- `sort_by` 'cost' | 'runs' | 'agent_count' | 'last_used' | 'first_used'
- `sort_order` 'asc' | 'desc'
- `email` string

## Response `200`

OK

- UsageUserUsagePage
  - `items` UsagePublicUserUsage[], required
    - `agent_count` integer, required
    - `first_used` string, date-time, required
    - `last_used` string, date-time, required
    - `ls_user_id` string
    - `run_count` integer, required
    - `total_cost` number, required: Estimated cost in USD from recorded traces.
    - `user_email` string, required: Recorded user email used to group usage.
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

- **2026-10-21** `9ea676f14305`: 1 info
  - added the new optional `query` request parameter `email`
- **2026-10-17** `c141773e30b5`: 1 breaking, 1 info
  - removed the required property `items/items/owner_email` from the response with the `200` status
  - added the required property `items/items/user_email` to the response with the `200` status
- **2026-10-16** `ec156df8da3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/v1/fleet/usage/users/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)