Supercheck LogoSupercheck
Runs API

List runs

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

GET
/api/runs

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.

Query Parameters

page?integer

Page number for pagination

Range1 <= value
Default1
limit?integer

Runs per page. Omitting limit returns up to 1000 matching runs.

Range1 <= value <= 1000
Default1000
jobId?string

Filter by job ID. An empty value means no filter; a malformed UUID returns 400.

Formatuuid
status?string

Filter by status

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

Response Body

Paginated list of runs

application/json
  1. response
pagination?
data?array<>
Example Request
curl -X GET 'https://demo.supercheck.dev/api/runs'
Example Response
{  "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",      "jobType": "playwright",      "status": "queued",      "trigger": "manual",      "triggeredByName": "string",      "triggeredByImage": "string",      "triggerKeyName": "string",      "duration": "string",      "durationMs": 0,      "startedAt": "2019-08-24T14:15:22Z",      "completedAt": "2019-08-24T14:15:22Z",      "logs": "string",      "errorDetails": "string",      "reportUrl": "string",      "testCount": 0,      "testId": "string",      "location": "string",      "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",      "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9"    }  ]}