---
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 returned by a previous request
- `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

## Changes

- **2026-05-05** `29fe492bf1e2` — 3 info
  - added the optional property `data/items/token_count_completion` to the response with the `200` status
  - added the optional property `data/items/token_count_prompt` to the response with the `200` status
  - added the optional property `data/items/token_count_total` to the response with the `200` status
- **2026-04-29** `c81391216eb5` — 3 warning
  - removed the optional property `data/items/token_count_completion` from the response with the `200` status
  - removed the optional property `data/items/token_count_prompt` from the response with the `200` status
  - removed the optional property `data/items/token_count_total` from the response with the `200` status

[Change history](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/changes/v1/projects/:project_identifier/traces/get.md)

---

[API](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/revisions/f440cb6427a5/schema)