Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

An API key (sig_...), or a session token from the web app.

Path Parameters

agentId
string<uuid>
required

The agent's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

attemptId
string<uuid>
required

The attempt's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

Response

The attempt.

object
enum<string>
required
Available options:
attempt
id
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

runId
string<uuid> | null
required

The run it belongs to.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

testId
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

testRevision
integer | null
required

The test revision it ran. Null on attempts stored before revisions.

persona
string
required

The persona slug played, or @source for the test's own caller.

attempt
integer
required

1 for the first try; 2 for the rerun of a failure; 2 and 3 for the repeats of a k of 3 cell.

version
integer | null
required

The agent version played.

result
enum<string> | null
required

This attempt's own result. The cell's combined result (flaky, k of 3) is in the run's result document.

Available options:
passed,
failed,
error,
drift,
null
reason
string | null
required

Why, in one line.

noFixture
string[]
required

Tools that answered with the fixed 'not available' error.

providerGrader
object
required

The voice platform's own grader result.

models
object
required

What played and scored it.

cost
object
required

Estimated cost of the attempt: Retell's share and Signal's.

rescoredAt
string<date-time> | null
required

Set when it was scored again from its transcript.

Example:

"2026-10-02T14:03:07.120Z"

startedAt
string<date-time>
required
Example:

"2026-10-02T14:03:07.120Z"

finishedAt
string<date-time> | null
required
Example:

"2026-10-02T14:03:07.120Z"

verdicts
object[]
required
findings
object[]
required

Problems Signal's own checks found on the transcript (code, title, severity, detail), whatever the criteria say.

drift
object | null
required

Whether the simulated caller stayed the source caller (drifted, reasons, notes). Null: no source to compare with.

scoreHistory
object[]
required

Earlier scores of this attempt, oldest first, each with the epoch it was scored in.

transcript
any

The conversation as the voice platform returned it, tool calls included. Its shape is the platform's, not normalised.