---
title: "List Traces"
method: GET
path: "/traces"
tags: ["traces"]
---

# List Traces

`GET /traces`

List traces

## Query parameters

- `name` string, nullable — The name of the trace to filter by, the name of a trace is the name of the root span of the trace
- `offset` integer — The offset to start the list from
- `limit` integer — The number of traces to return

## Response `200`

Successful Response

- PaginatedResponseListTracesResponse
  - `meta` Meta, required
    - `total_count` integer, required — Total number of items in the collection
  - `data` ListTracesResponse[], required — List of items returned in the response
    - `id` string, uuid, required — The id of the trace
    - `start_time` string, date-time, nullable — The start time of the trace
    - `end_time` string, date-time, nullable — The end time of the trace
    - `duration_ms` integer, nullable — The duration of the trace
    - `status` string, nullable — The status of the trace
    - `name` string, nullable — The name of the trace, set to the name of the root span of the trace
    - `input` string, nullable — The input of the trace, set to the input of the root span of the trace
    - `output` string, nullable — The output of the trace, set to the output of the root span of the trace
    - `total_tokens` integer, nullable — The total tokens of the trace
    - `span_count` integer, nullable — Total number of spans in the trace
    - `generation_count` integer, nullable — Number of LLM generation spans in the trace
    - `tool_count` integer, nullable — Number of tool/function call spans in the trace
    - `has_error` boolean, nullable — Whether any span in the trace has an error

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required (out of credits)
- `404` — Not Found
- `422` — Request Validation Error

---

[API](https://skmtc.dev/opper/apis/opper-api-v2.md) · [All operations](https://skmtc.dev/opper/apis/opper-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opper/opper-api-v2/revisions/d3ccdaa15678/schema)