---
title: "GA4GH: Retrieve run status"
method: GET
path: "/ga4gh/wes/v1/runs/{run_id}/status"
tags: ["ga4gh"]
---

# GA4GH: Retrieve run status

`GET /ga4gh/wes/v1/runs/{run_id}/status`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Uses the GA4GH workflow execution service API to retrieve the status of the run associated with the given `run_id`.

## Path parameters

- `run_id` string, required

## Response `200`

OK

- RunStatus
  - `run_id` string
  - `state` 'UNKNOWN' | 'QUEUED' | 'INITIALIZING' | 'RUNNING' | 'PAUSED' | 'COMPLETE' | 'EXECUTOR_ERROR' | 'SYSTEM_ERROR' | 'CANCELED' | 'CANCELING'

## Other responses

- `400`: Bad request
- `403`: Operation not allowed
- `404`: Run not found

## Changes

> 19 revisions in range; 1 not diffed.

- **2026-10-20** `adab9fd613a4`: 1 info
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-08-27** `97f7655d105a`: 1 info
  - added the non-success response with the status `404`

[Operation history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/ga4gh/wes/v1/runs/:run_id/status/get.md)

---

[API](https://skmtc.dev/seqeralabs/apis/seqera-api.md) - [All operations](https://skmtc.dev/seqeralabs/apis/seqera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seqeralabs/apis/seqera-api/revisions/adab9fd613a4?raw)