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

# List Fleet agent costs

`GET /v1/fleet/usage/agents`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/v1/fleet/usage/agents`
- 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 agent cost report as the Fleet usage UI. 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' | 'last_used' | 'first_used'
- `sort_order` 'asc' | 'desc'

## Response `200`

OK

- UsageAgentUsagePage
  - `items` UsagePublicAgentUsage[], required
    - `agent_id` string, required
    - `agent_name` string
    - `first_used` string, date-time, required
    - `last_used` string, date-time, required
    - `model_name` string
    - `run_count` integer, required
    - `total_cost` number, required: Estimated cost in USD from recorded traces.
  - `next_cursor` string, nullable, required

## Other responses

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

## Changes

- **2026-10-17** `c141773e30b5`: 1 breaking, 1 warning, 1 info
  - removed the required property `items/items/assistant_id` from the response with the `200` status
  - removed the optional property `items/items/owner_email` from the response with the `200` status
  - added the required property `items/items/agent_id` 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/agents/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)