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

# GA4GH: Describe run

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

## Request

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

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

## Path parameters

- `run_id` string, required

## Response `200`

OK

- RunLog
  - `outputs` object
  - `request` RunRequest
    - `tags` object
    - `workflow_engine_parameters` object
    - `workflow_params` string
    - `workflow_type` string
    - `workflow_type_version` string
    - `workflow_url` string
  - `run_id` string
  - `run_log` Log
    - `cmd` string[]
    - `end_time` string
    - `exit_code` integer
    - `name` string
    - `start_time` string
    - `stderr` string
    - `stdout` string
  - `state` 'UNKNOWN' | 'QUEUED' | 'INITIALIZING' | 'RUNNING' | 'PAUSED' | 'COMPLETE' | 'EXECUTOR_ERROR' | 'SYSTEM_ERROR' | 'CANCELED' | 'CANCELING'
  - `task_logs` Log[]
    - `cmd` string[]
    - `end_time` string
    - `exit_code` integer
    - `name` string
    - `start_time` string
    - `stderr` string
    - `stdout` string

## 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`
- **2026-04-20** `b2b5cc41d473`: 1 breaking
  - the `outputs` response's property type changed from no type to `object` for status `200`
- **2026-01-20** `98d6b538c88e`: 1 breaking
  - the `outputs` response's property type changed from `object` to no type for status `200`

[Operation history](https://skmtc.dev/seqeralabs/apis/seqera-api/changes/ga4gh/wes/v1/runs/:run_id/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)