---
title: "Get the status of a pipeline run"
method: GET
path: "/apps/{appId}/runs/{runId}/status"
tags: ["Pipelines"]
---

# Get the status of a pipeline run

`GET /apps/{appId}/runs/{runId}/status`

## Request

- Base URL: `https://pipeline-portal.home.mendix.com/api/v1`
- URL: `https://pipeline-portal.home.mendix.com/api/v1/apps/{appId}/runs/{runId}/status`
- Auth: API key in header `Authorization`

Retrieves the status of a pipeline run. The operation returns a pipeline run status. Every request must be authenticated by a personal access token containing the scope `mx:pipelines:read`.

## Response `200`

200 Get Status response

- RunStatus: Run status details.
  - `runId` string, uuid, required: The unique run ID in UUID format.
  - `status` 'CREATED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED', required: An array of possible pipeline run statuses.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not Found

---

[API](https://skmtc.dev/mendix/apis/mendix-pipelines-api.md) - [All operations](https://skmtc.dev/mendix/apis/mendix-pipelines-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/mendix-pipelines-api/revisions/54d51b38e0e3?raw)