---
title: "List traces for a project"
method: GET
path: "/v1/projects/{project_identifier}/traces"
tags: ["traces"]
---

# List traces for a project

`GET /v1/projects/{project_identifier}/traces`

## Path parameters

- `project_identifier` string, required — The project identifier: either project ID or project name.

## Query parameters

- `start_time` string, date-time, nullable — Inclusive lower bound on trace start time (ISO 8601)
- `end_time` string, date-time, nullable — Exclusive upper bound on trace start time (ISO 8601)
- `sort` 'start_time' | 'latency_ms' — Sort field
- `order` 'asc' | 'desc' — Sort direction
- `limit` integer — Maximum number of traces to return
- `cursor` string, nullable — Pagination cursor (Trace GlobalID)
- `include_spans` boolean — If true, include full span details for each trace. This significantly increases response size and query latency, especially with large page sizes. Prefer fetching spans lazily for individual traces when possible.
- `session_identifier` string[], nullable — List of session identifiers to filter traces by. Each value can be either a session_id string or a session GlobalID. Only traces belonging to the specified sessions will be returned.

## Response `200`

Successful Response

- GetTracesResponseBody
  - `data` TraceData[], required
    - `id` string, required
    - `trace_id` string, required
    - `project_id` string, required
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `token_count_prompt` integer — Cumulative prompt token count across all spans in the trace.
    - `token_count_completion` integer — Cumulative completion token count across all spans in the trace.
    - `token_count_total` integer — Cumulative total token count across all spans in the trace (prompt + completion).
    - `spans` TraceSpanData[], nullable
      - `id` string, required
      - `span_id` string, required
      - `parent_id` string, nullable, required
      - `name` string, required
      - `span_kind` string, required
      - `status_code` string, required
      - `start_time` string, date-time, required
      - `end_time` string, date-time, required
  - `next_cursor` string, nullable, required

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/versions/5339b2afd3a2/schema)