Supercheck LogoSupercheck
Runs API

List runs

List job runs with optional filters for job ID and status.

GET
/api/runs

Authorization

bearerAuth
AuthorizationBearer <token>

CLI token (sck_live_*) for full API access, or trigger key (sck_trigger_* / legacy job_*) for job trigger endpoint only.

In: header

Query Parameters

page?integer

Page number for pagination

Default1
Range1 <= value
limit?integer

Items per page

Default20
Range1 <= value <= 100
jobId?string

Filter by job ID

Formatuuid
status?string

Filter by status

Value in"queued" | "running" | "passed" | "failed" | "error" | "blocked"

Response Body

application/json

application/json

curl -X GET "https://demo.supercheck.dev/api/runs"
{
  "pagination": {
    "total": 0,
    "page": 0,
    "limit": 0,
    "totalPages": 0,
    "hasNextPage": true,
    "hasPrevPage": true
  },
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39",
      "jobName": "string",
      "status": "queued",
      "trigger": "manual",
      "duration": "string",
      "location": "string",
      "jobType": "string",
      "reportUrl": "string",
      "testCount": 0,
      "createdAt": "2019-08-24T14:15:22Z",
      "completedAt": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "error": "Unauthorized"
}