> For the complete documentation index, see [llms.txt](https://docs.arcee.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.arcee.ai/arcee-orchestra/workflows/api-invocation/workflow-runs-api.md).

# Workflow Runs API

Check a workflow run

You can start a workflow from API with the [Workflow Execution API](/arcee-orchestra/workflows/api-invocation/workflow-execution-api.md), returning the `run_id` of the workflow in question\
\
To check the status of the run, you can use the following API.

```
response = requests.get(f"{API_BASE_URL}/workflows/{workflow_id}/runs/{run_id}", headers=headers)
run_details = response.json()
run_details
```

This will return the details of the run - such as<br>

```
[{'id': 'THE_RUN_ID',
  'status': 'completed',
  'start_time': '2025-04-24T03:18:12.322630Z',
  'end_time': '2025-04-24T03:18:13.048954Z',
  'elapsed_time': 0,
  'error': None,
  'outputs': {'query': 'Hello from Python',
   'model_1': 'Hello there! How can I assist you today?'},
  'all_outputs': {'query': 'Hello from Python',
   'model_1': 'Hello there! How can I assist you today?'},
  'inputs': {'query': 'Hello from Python'}}]

```

To check the granular status of each step you can check the [Workflow Execution Steps API](/arcee-orchestra/workflows/api-invocation/workflow-execution-steps-api.md).