Supercheck LogoSupercheck
Runs API

Get run status

Quick status check for a run. Useful for polling in CI/CD pipelines.

GET
/api/runs/{runId}/status

Authorization

bearerAuth
headerAuthorizationBearer <token>

Project-scoped CLI token (sck_live_* or sck_test_*) for documented API operations that accept bearer authentication. Interactive browser operations may require a session cookie. Trigger keys (sck_trigger_* / legacy job_*) are accepted only by job trigger endpoints.

Path Parameters

runId*string

Run ID

Formatuuid

Response Body

Run status

application/json
  1. response
runId?string
Formatuuid
jobId?string
Formatuuid
status?string
Value in"queued""running""passed""failed""error""blocked"
startedAt?string
Formatdate-time
completedAt?string
Formatdate-time
durationMs?integer

Duration in milliseconds

errorDetails?string
reportUrl?string

URL to the detailed run report

Example Request
curl -X GET 'https://demo.supercheck.dev/api/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/status'
Example Response
{  "runId": "78c33d18-170c-44d3-a227-b3194f134f73",  "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39",  "status": "queued",  "startedAt": "2019-08-24T14:15:22Z",  "completedAt": "2019-08-24T14:15:22Z",  "durationMs": 0,  "errorDetails": "string",  "reportUrl": "string"}