Skip to main content
GET
/
v1
/
projects
/
{project_identifier}
/
traces
List traces for a project
curl --request GET \
  --url https://api.example.com/v1/projects/{project_identifier}/traces
{
  "data": [
    {
      "id": "<string>",
      "trace_id": "<string>",
      "project_id": "<string>",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "token_count_prompt": 0,
      "token_count_completion": 0,
      "token_count_total": 0,
      "spans": [
        {
          "id": "<string>",
          "span_id": "<string>",
          "parent_id": "<string>",
          "name": "<string>",
          "span_kind": "<string>",
          "status_code": "<string>",
          "start_time": "2023-11-07T05:31:56Z",
          "end_time": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ],
  "next_cursor": "<string>"
}

Path Parameters

​
project_identifier
string
required

The project identifier: either project ID or project name.

Query Parameters

​
start_time
string<date-time> | null

Inclusive lower bound on trace start time (ISO 8601)

​
end_time
string<date-time> | null

Exclusive upper bound on trace start time (ISO 8601)

​
sort
enum<string>
default:start_time

Sort field

Available options:
start_time,
latency_ms
​
order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
limit
integer
default:100

Maximum number of traces to return

Required range: x <= 1000
​
cursor
string | null

Pagination cursor (Trace GlobalID)

​
include_spans
boolean
default:false

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[] | null

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

Successful Response

​
data
TraceData · object[]
required
​
next_cursor
string | null
required