---
title: "Get run status"
method: GET
path: "/api/runs/{runId}/status"
tags: ["Runs"]
---

# Get run status

`GET /api/runs/{runId}/status`

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

## Response `200`

Run status

- RunStatusResponse
  - `runId` string, uuid
  - `jobId` string, uuid, nullable
  - `status` 'queued' | 'running' | 'passed' | 'failed' | 'error' | 'blocked'
  - `startedAt` string, date-time, nullable
  - `completedAt` string, date-time, nullable
  - `durationMs` integer, nullable — Duration in milliseconds
  - `errorDetails` string, nullable
  - `reportUrl` string, nullable — URL to the detailed run report

## Other responses

- `401` — Authentication required or token invalid
- `404` — Resource not found

## Changes

- **2026-03-21** `40aeed2ccba7` — 1 breaking
  - the response property `jobId` became nullable for the status `200`

[Change history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/runs/:runId/status/get.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) · [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supercheck-io/supercheck-api/revisions/81782deccf0e/schema)