---
title: "Fetch workflow status by workflowId"
method: GET
path: "/v1/li/workflows/status/{workflowId}"
tags: ["Bulk Routing API", "Bulk Multipass API", "Bulk Data Graph API", "Bulk Order Management API", "Bulk Analysis API"]
---

# Fetch workflow status by workflowId

`GET /v1/li/workflows/status/{workflowId}`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/li/workflows/status/{workflowId}`
- Auth: HTTP bearer

This endpoint returns the current status of a workflow execution (e.g., RUNNING, COMPLETED, FAILED)  identified by the given workflowId. The request must include workflowId as a path variable whose status is to be fetched.

## Path parameters

- `workflowId` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Successfully retrieved workflow status.

- WorkflowStatusResponse
  - `status` 'SCHEDULED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'UNKNOWN': Current status of the workflow
  - `progress` integer: Percentage of the workflow completed so far (0-100). May be null if progress has not been reported yet.
  - `orderId` string: OrderID generated for the respective workflow
  - `downloadUrl` string: Pre-signed S3 download URL for the output file. Available only when the workflow is COMPLETED.
  - `downloadUrls` DatasetDownloadUrl[]: List of pre-signed download URLs for files in each dataset folder. Available only when workflow is COMPLETED and folders exist.
    - `datasetName` string
    - `downloadUrl` string
  - `error` ErrorDetail: Error details
    - `code` string: A unique code representing the specific error
    - `detail` string, required: A detailed message describing the error.
  - `rowCount` integer: Total number of rows processed by the workflow. Available only when the workflow is COMPLETED and the worker has reported it.

## Other responses

- `400`: Unable to retrieve workflow status
- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `404`: Workflow ID not found
- `429`: Too many requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis.md) · [All operations](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis/revisions/989567dcef87?raw)