Skip to main content
GET
List Trace Scores

Authorizations

Authorization
string
header
required

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

Query Parameters

trace_id
string<uuid> | null

Filter by trace UUID

name
string | null

Filter by metric name (exact match)

source
enum<string> | null

Filter by score source: AUTOMATED, ANNOTATION, PROGRAMMATIC Who produced the score judgment (not how it arrived).

AUTOMATED -- the eval system's LLM judge produced this score ANNOTATION -- a human assigned this score manually PROGRAMMATIC -- external code submitted this score via API/SDK

Available options:
AUTOMATED,
ANNOTATION,
PROGRAMMATIC
status
enum<string> | null

Filter by score status: SUCCESS, FAILED, PENDING Outcome of a trace score evaluation attempt.

Available options:
SUCCESS,
FAILED,
PENDING
data_type
enum<string> | null

Filter by data type: NUMERIC, BOOLEAN, CATEGORICAL Data type for a trace score value.

Available options:
NUMERIC,
BOOLEAN,
CATEGORICAL
eval_run_id
string<uuid> | null

Filter by eval run UUID

environment
string | null

Filter by trace environment (exact match)

date_from
string<date-time> | null

ISO 8601 datetime. Include scores created on or after.

date_to
string<date-time> | null

ISO 8601 datetime. Include scores created before (exclusive).

limit
integer
default:50

Page size

Required range: 1 <= x <= 200
offset
integer
default:0

Number of items to skip

Required range: x >= 0

Response

Successful Response

items
TraceScoreResponse · object[]
required
total
integer
required
limit
integer
required
offset
integer
required