---
title: "Retrieve outputs of a specific step in a DAG-run"
method: GET
path: "/dag-runs/{name}/{dagRunId}/steps/{stepName}/outputs"
tags: ["dag-runs"]
---

# Retrieve outputs of a specific step in a DAG-run

`GET /dag-runs/{name}/{dagRunId}/steps/{stepName}/outputs`

## Request

- Base URL: `http://localhost/api/v1`
- URL: `http://localhost/api/v1/dag-runs/{name}/{dagRunId}/steps/{stepName}/outputs`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - none

Fetches the persisted outputs and the output variable of one step in a DAG-run. The stepName parameter accepts a step name or a step id. The runtime masks secret values before it persists them. Each value is cut at 65536 bytes.

## Path parameters

- `name` string, regex, required: Name of the DAG
- `dagRunId` string, required: Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.
- `stepName` string, required

## Query parameters

- `remoteNode` string

## Response `200`

A successful response

- StepOutputs: Persisted outputs of one step in a DAG-run.
  - `stepName` string, required
  - `stepId` string
  - `status` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9, required: Numeric status code indicating current node state: 0: "Not started" 1: "Running" 2: "Failed" 3: "Aborted" 4: "Success" 5: "Skipped" 6: "Partial Success" 7: "Waiting for manual action" 8: "Rejected" 9: "Retrying"
  - `statusLabel` 'not_started' | 'running' | 'failed' | 'aborted' | 'succeeded' | 'skipped' | 'partially_succeeded' | 'waiting' | 'rejected' | 'retrying', required: Human-readable status description for the node
  - `outputs` StepOutputValue[], required
    - `name` string, required
    - `value` string, required
    - `truncated` boolean, required: True when the value was cut.
    - `size` integer, required: Size of the value in bytes before the cut.
  - `outputVariable` StepOutputValue: One output value of a step. The value is cut at 65536 bytes.
    - `name` string, required
    - `value` string, required
    - `truncated` boolean, required: True when the value was cut.
    - `size` integer, required: Size of the value in bytes before the cut.

## Other responses

- `404`: DAG-run or step not found
- `default`: Generic error response

## Changes

> 208 revisions in range; 1 not diffed.

- **2026-10-31** (v1) `f3177cd9b416`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dagucloud/apis/dagu/changes/dag-runs/:name/:dagRunId/steps/:stepName/outputs/get.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) - [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) - [OpenAPI document](https://skmtc.dev/dagucloud/apis/dagu/revisions/742c8ecb39ce?raw)