---
title: "Pipeline Steps Status"
method: GET
path: "/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/steps"
tags: ["Pipeline Execution"]
---

# Pipeline Steps Status

`GET /v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/steps`

## Request

- Base URL: `https://eu1.api.matillion.com/dpc`
- URL: `https://eu1.api.matillion.com/dpc/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/steps`
- Auth: HTTP bearer

Represents a single execution of a pipeline triggered from a step of another pipeline.

## Path parameters

- `projectId` string, required
- `pipelineExecutionId` string, uuid, required

## Query parameters

- `page` unknown
- `size` unknown

## Response `200`

Pipeline status has been retrieved

- PagedResultListPipelineExecutionStepResult
  - `page` integer: The 0-indexed page number of the returned results.
  - `results` PipelineExecutionStepResult[]: Page of results or empty.
    - `childPipeline` ChildPipelineInfo
      - `id` string: Unique identifier for this step execution.
      - `name` string: The name of this step - usually the name of the component as written at design time.
    - `id` string: Unique identifier for this step execution.
    - `name` string: The name of this step - usually the name of the component as written at design time.
    - `result` PipelineExecutionResult
      - `finishedAt` string, date-time: Time pipeline execution finished
      - `message` string: Message returned by pipeline execution
      - `startedAt` string, date-time: Time pipeline execution started
      - `status` string: Status of executed pipeline
  - `size` integer: The size of each page of results.
  - `total` integer: Total number of available results across all pages.

## Other responses

- `400`: Wrong request parameters used
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Pipeline Execution not Found
- `500`: Unexpected error occurred
- `504`: Gateway timeout

---

[API](https://skmtc.dev/maia/apis/maia-public-rest-api.md) - [All operations](https://skmtc.dev/maia/apis/maia-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maia/apis/maia-public-rest-api/revisions/6239825f68eb?raw)