# List workflow run step logs

> Every log of the given runs, from each run's start to its end (one entry per step with its input and output), as a JSON array ordered by created_time.

Source: https://docs.stacksync.com/api-reference/workflows/runs/list_workflow_run_logs

`GET https://api.stacksync.com/v1/workspaces/{workspace_id}/workflows/id/{workflow_id}/executions/logs/between`

- Operation: `list_workflow_run_logs`
- Resource: Workflow runs
- Access: read-only

## Authentication

- `Authorization: Bearer <key>`: A workspace API key (workspace_…, created by a workspace owner under Workspace settings > Stacksync API) acts with editor rights on that workspace only; a user API key (user_…, created under Profile > Stacksync API) acts as that user in every workspace they belong to. POST, PUT and PATCH requests must send Content-Type: application/json. Every authentication failure answers 403.

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `workspace_id` | integer | Yes | The workspace. List the ones your key can reach with GET /v1/workspaces. |
| `workflow_id` | string (uuid) | Yes | The workflow. |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `region` | string \| null | No | Region of the workflow: besg or usnv. Required: without it the route answers 404 |
| `include_execution_ids` | string \| null | No | The runs, comma-separated UUIDs |

## Returns

### 200 OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string \| null | No |  |
| `created_time` | any | No |  |
| `workflow_execution_id` | string \| null | No |  |
| `workflow_module_instance_id` | string \| null | No |  |
| `workflow_version` | string \| null | No |  |
| `log_type` | string \| null | No |  |
| `execution_status` | string \| null | No |  |
| `execution_duration` | integer \| null | No |  |
| `metadata` | any | No |  |
| `data` | any | No |  |

## Example request

```bash
curl -X GET "https://api.stacksync.com/v1/workspaces/{workspace_id}/workflows/id/{workflow_id}/executions/logs/between?region=usnv" \
  -H "Authorization: Bearer $STACKSYNC_API_KEY"
```

## Example response (200)

```json
[
  {
    "id": "<id>",
    "created_time": "<created_time>",
    "workflow_execution_id": "<workflow_execution_id>",
    "workflow_module_instance_id": "<workflow_module_instance_id>",
    "workflow_version": "<workflow_version>",
    "log_type": "<log_type>",
    "execution_status": "<execution_status>",
    "execution_duration": 0,
    "metadata": "<metadata>",
    "data": "<data>"
  }
]
```

## Errors

| Status | Meaning | Body |
| --- | --- | --- |
| 400 | Bad Request | `{ "error": string }` |
| 403 | Forbidden | `{ "error": string }` |
| 404 | Not Found | `{ "error": string }` |
| 422 | Unprocessable Content | `{ "error": string }` |

## Related

- [API Reference overview](https://docs.stacksync.com/api-reference): base URLs, regions, pagination, idempotency and errors
- [Authentication](https://docs.stacksync.com/api-reference/authentication): API keys and the 403 answers
- OpenAPI document: https://docs.stacksync.com/openapi.json
- [List execution logs](https://docs.stacksync.com/api-reference/workflows/runs/list_workflow_runs)
- [Get export capabilities](https://docs.stacksync.com/api-reference/workflows/runs/get_workflow_run_export_capabilities)
- [Replay executions](https://docs.stacksync.com/api-reference/workflows/runs/replay_workflow_runs)
- [Replay executions by filter](https://docs.stacksync.com/api-reference/workflows/runs/replay_workflow_runs_by_filter)
- [Resolve executions by filter](https://docs.stacksync.com/api-reference/workflows/runs/resolve_workflow_runs_by_filter)