---
title: "List trace spans"
method: GET
path: "/v3/traces/{trace_id}/spans"
tags: ["Traces"]
---

# List trace spans

`GET /v3/traces/{trace_id}/spans`

List canonical span summaries for a trace.

## Path parameters

- `trace_id` string, required

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

OK

- ListTraceSpansResponse
  - `object` string
  - `data` SpanSummary[]
    - `object` string
    - `trace_id` string
    - `span_id` string
    - `parent_span_id` string
    - `name` string
    - `type` string
    - `operation` string
    - `status` string
    - `started_at` string, date-time
    - `ended_at` string, date-time
    - `duration_ms` number, double
    - `provider` string
    - `model` string
    - `usage` TraceUsage
      - `prompt_tokens` integer
      - `completion_tokens` integer
      - `total_tokens` integer
      - `prompt_cached_tokens` integer
      - `prompt_audio_tokens` integer
      - `completion_reasoning_tokens` integer
      - `completion_audio_tokens` integer
      - `completion_accepted_prediction_tokens` integer
      - `completion_rejected_prediction_tokens` integer
    - `cost` TraceCost
      - `input` number, double
      - `output` number, double
      - `cache_read` number, double
      - `cache_write` number, double
      - `reasoning` number, double
      - `web_search` number, double
      - `total` number, double
      - `currency` string
      - `cached` number, double
      - `audio_input` number, double
      - `audio_output` number, double
      - `accepted_prediction` number, double
      - `rejected_prediction` number, double
      - `billable` boolean
      - `pricing_tier` string
      - `threshold_exceeded` boolean
      - `integration_id` string
    - `has_detail` boolean
  - `has_more` boolean
  - `next_page_token` string

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/3c22f56a94b4/schema)