---
title: "Query Step Output"
method: POST
path: "/api/v1/steps/{step_id}/output/query"
tags: ["step-output"]
---

# Query Step Output

`POST /api/v1/steps/{step_id}/output/query`

Run a DuckDB SQL query over the step's latest Parquet output (table alias 'data').

## Path parameters

- `step_id` string, uuid, required

## Query parameters

- `limit` integer

## Request body

- StepOutputQueryRequest
  - `sql` string, required
  - `table` string, nullable

## Response `200`

Successful Response

- DataQueryResponse
  - `columns` string[], required
  - `rows` object[], required
  - `total_rows` integer, required
  - `truncated` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/revisions/a59877bf911b/schema)