---
title: "Retrieve run details"
method: GET
path: "/get_pl_run"
tags: ["Data Access"]
---

# Retrieve run details

`GET /get_pl_run`

This endpoint can be used to poll for completion and retrieve final flow outputs. Output nodes must be used to retrieve outputs.

## Query parameters

- `run_id` string, required
- `user_id` string
- `project_id` string

## Response `200`

Successful retrieval of flow run details

- object
  - `user_id` string — The id for the user initiating the flow.
  - `state` 'RUNNING' | 'DONE' | 'TERMINATING' | 'FAILED' | 'TERMINATED' | 'QUEUED'
  - `outputs` object — JSON object where keys are the `output_name` parameters of your Gumloop Output nodes and the values are the values that get sent to your node.
  - `created_ts` string, date-time — Timestamp for when the flow was started.
  - `finished_ts` string, date-time — Timestamp for when the flow completed.
  - `log` string[] — A list of log entries from your Gumloop flow run.

## Other responses

- `400` — Bad request (missing run_id)
- `404` — Flow run not found

---

[API](https://skmtc.net/gumloop/apis/public-api.md) · [All operations](https://skmtc.net/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gumloop/public-api/versions/115f2d6ce387/schema)