---
title: "Get Agent Trace"
method: GET
path: "/v1/traces/{trace_id}"
tags: ["agent tracing"]
---

# Get Agent Trace

`GET /v1/traces/{trace_id}`

## 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/{trace_id}`
- Auth: API key in header `x-litellm-api-key`

## Path parameters

- `trace_id` string, required

## Query parameters

- `trace_ref` string
- `cursor` string, nullable
- `page_size` integer, nullable

## Response `200`

Successful Response

- Trace
  - `summary` 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
  - `agents` AgentNode[], required
    - `name` string, required
    - `parent_agent` string, nullable, required
    - `invocations` integer, required
    - `llm_calls` integer, required
    - `tool_calls` integer, required
    - `duration_ms` number, required
    - `spend` number, nullable, required
    - `priced_calls` integer, required
  - `spans` Span[], required
    - `span_id` string, required
    - `parent_span_id` string, nullable, required
    - `name` string, required
    - `type` 'agent' | 'llm' | 'tool' | 'chain' | 'framework' | 'retriever' | 'embedding' | 'reranker' | 'guardrail' | 'evaluator' | 'prompt' | 'decision', required
    - `agent` string, required
    - `framework` string, required
    - `start_offset_ms` number, required
    - `duration_ms` number, required
    - `status` 'ok' | 'error' | 'unset', required
    - `error` string, nullable, required
    - `error_truncated` boolean, required
    - `input_preview` string, required
    - `model` string, nullable, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `litellm_request_id` string, nullable, required
    - `spend` number, nullable, required
    - `spend_log_request_id` string, nullable, required
    - `spend_match` 'matched' | 'no_call_id' | 'no_spend_log' | 'ambiguous' | 'incomplete_evidence', nullable, required
  - `next_cursor` string, nullable

## 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/:trace_id/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)