---
title: "Get Pipeline Execution"
method: GET
path: "/api/v1/pipelines/executions/{execution_id}"
tags: ["pipelines"]
---

# Get Pipeline Execution

`GET /api/v1/pipelines/executions/{execution_id}`

Poll execution status. Returns per-step status with lookup keys for partial results.

Decision rule: Check PG PipelineExecution.status first.
- If terminal (completed/failed): return from PostgreSQL (post-sync, complete data)
- If running/pending: read Firestore for real-time step status

## Path parameters

- `execution_id` string, required

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Response `200`

Successful Response

- PipelineExecutionResponse
  - `execution_id` string, required
  - `pipeline_id` string, required
  - `pipeline_version` integer, required
  - `status` string, required
  - `steps` PipelineExecutionStepResponse[], required
    - `step_index` integer, required
    - `step_type` string, required
    - `status` string, required
    - `lookup_key` string, nullable
    - `result_url` string, nullable
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `error_message` string, nullable
    - `source_step_type` string, nullable
    - `checkpoint_id` string, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `created` string, date-time, nullable
  - `config_snapshot` object, nullable
  - `input_config` object, nullable
  - `rate_breakdown` object, nullable

## Other responses

- `422` — Validation Error

---

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