Skip to main content
GET /api/v1/runs/
Poll a run’s status and, once finished, its report link. Call this on the ids returned by Run tests until the status is terminal.

Request

string
required
The run id, in the URL path.
string
required
Bearer <your API key>.

Response

string
The run id.
string
One of queued, running, passed, failed, error, cancelled. The last four are terminal.
string | null
The agent’s explanation of the verdict, when finished.
string | null
Direct link to the run’s video recording, when available.
string
A signed, login-free link to the full run report (valid for 30 days). Good for CI logs and PR comments.

Polling pattern

Prefer the clickproof-ai/run-tests Action over hand-rolled polling — it handles the whole upload → run → poll → report loop and sets the job’s exit code for you.