Skip to main content
GET
Get a trace

Authorizations

Authorization
string
header
required

An Egma API key.

Path Parameters

traceId
string
required

Query Parameters

from
string<date-time>
required
to
string<date-time>
required
projectId
string
Minimum string length: 1

Response

The trace and its grades.

trace
object
required
turns
object[]
required
spans
object[]
required
spansTruncated
boolean
required
metrics
object[]
required
simulationId
string | null
required
Minimum string length: 1
gradingState
enum<string>
required
Available options:
not_requested,
pending,
running,
complete,
error
workBlock
object | null
required
grades
object[]
required

The current result for each selected grader. Each grade has its own score, frozen threshold, result, and supporting details.

gradeHistory
object[]
required

Recorded grade results, including previous grading attempts. Regrading preserves this history.

combinedScore
number | null
required

Display-only arithmetic mean when every selected grader has a current score. Null while a required score is missing or errored. This is not an overall pass/fail result.

Required range: 0 <= x <= 1