---
title: "get pipeline run status"
method: GET
path: "/api/v1/projects/{projectName}/pipelines/{pipelineName}/runs/{runName}/status"
tags: ["pipeline"]
---

# get pipeline run status

`GET /api/v1/projects/{projectName}/pipelines/{pipelineName}/runs/{runName}/status`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/kubevela/apis/kubevela-api-doc/docs/api/v1/projects/:projectName/pipelines/:pipelineName/runs/:runName/status/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `projectName` string, required
- `pipelineName` string, required
- `runName` string, required

## Response `200`

OK

- V1PipelineRunStatus
  - `conditions` ConditionCondition[]
    - `lastTransitionTime` string, required
    - `message` string
    - `reason` string, required
    - `status` string, required
    - `type` string, required
  - `contextBackend` V1ObjectReference: ObjectReference contains enough information to let you inspect or modify the referred object.
    - `apiVersion` string: API version of the referent.
    - `fieldPath` string: If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object.
    - `kind` string: Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
    - `name` string: Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
    - `namespace` string: Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
    - `resourceVersion` string: Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
    - `uid` string: UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
  - `endTime` string
  - `finished` boolean, required
  - `message` string
  - `mode` V1alpha1WorkflowExecuteMode, required
    - `steps` string
    - `subSteps` string
  - `startTime` string
  - `status` string, required
  - `steps` V1alpha1WorkflowStepStatus[]
    - `firstExecuteTime` string
    - `id` string, required
    - `lastExecuteTime` string
    - `message` string
    - `name` string
    - `phase` string
    - `reason` string
    - `subSteps` V1alpha1StepStatus[]
      - `firstExecuteTime` string
      - `id` string, required
      - `lastExecuteTime` string
      - `message` string
      - `name` string
      - `phase` string
      - `reason` string
      - `type` string
    - `type` string
  - `suspend` boolean, required
  - `suspendState` string
  - `terminated` boolean, required
  - `loops` object

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/kubevela/apis/kubevela-api-doc.md) - [All operations](https://skmtc.dev/kubevela/apis/kubevela-api-doc/llms.txt) - [OpenAPI document](https://skmtc.dev/kubevela/apis/kubevela-api-doc/revisions/f2cd6d5cf4c6?raw)