Skip to main content
GET
Search traces (structural)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

project_id
string
required

Project ID.

query
string

Search query.

tool_name
string

Tool name filter.

model
string

Model filter.

agent_name
string

Agent name filter.

has_error
boolean

Span-error axis. true = only traces with span errors, false = only traces without, omitted = unconstrained. Independent of has_issues.

has_issues
boolean

Issue axis. true = only traces with issue occurrences, false = only traces without, omitted = unconstrained. has_error=false with has_issues=true selects silent failures.

status
string

Deprecated alias for the two axes, comma-separated: failures = has_error=true, flagged = has_issues=true, clean = has_error=false and has_issues=false. Cannot express error-only or issue-only; prefer has_error / has_issues, which override it per axis.

error_only
boolean

Restrict the span-level search to error spans. Distinct from has_error, which filters whole traces by error count.

tool_error_only
boolean

Same-span tool-error filter. Requires tool_name. Matches only traces where that tool failed on the same span the Analytics widget counted.

start
string

Start timestamp.

end
string

End timestamp.

min_spans
string

Minimum span count.

max_spans
string

Maximum span count.

min_duration_ms
string

Minimum trace duration (ms).

max_duration_ms
string

Maximum trace duration (ms).

min_tokens
string

Minimum total token count.

min_thread_traces
string

Minimum thread trace count.

max_thread_traces
string

Maximum thread trace count.

attribute_filters
string

JSON-serialized span attribute filters.

limit
integer

Maximum number of records to return.

Required range: x >= 1

Response

Search results

id
string
required
otel_trace_id
string
required
project_id
string
required
service_name
string | null
required
timestamp
string<date-time>
required
issue_extraction
object | null
required