---
title: "List Agent Traces"
method: GET
path: "/v1/traces"
tags: ["agent tracing"]
---

# List Agent Traces

`GET /v1/traces`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/v1/traces`
- Auth: API key in header `x-litellm-api-key`

## Query parameters

- `start_ms` integer, nullable: Window start, unix ms. Default: 24h ago
- `end_ms` integer, nullable: Window end, unix ms. Default: now
- `cursor` string, nullable

## Response `200`

Successful Response

- TracePage
  - `data` TraceSummary[], required
    - `resolution_limited` boolean
    - `trace_id` string, required
    - `trace_ref` string
    - `name` string, required
    - `service` string, required
    - `agent_names` string[]
    - `frameworks` string[]
    - `input_preview` string, required
    - `start_time` string, required
    - `duration_ms` number, required
    - `status` 'ok' | 'error' | 'unset', required
    - `span_count` integer, required
    - `agent_count` integer, required
    - `agent_invocations` integer, required
    - `llm_calls` integer, required
    - `tool_calls` integer, required
    - `error_count` integer, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `models` string[], required
    - `spend` number, nullable, required
    - `priced_calls` integer, required
    - `source` RunSource
      - `type` 'slack' | 'teams' | 'discord' | 'linear' | 'github' | 'jira' | 'custom', required
      - `url` string, required
      - `title` string, required
      - `user` string
  - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/v1/traces/get.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)