---
title: "List Workflow Logs"
method: GET
path: "/workflows/logs"
tags: ["Workflow Runs"]
---

# List Workflow Logs

`GET /workflows/logs`

**Available for**: Chatflow, Workflow apps.

List past workflow runs with optional filters. Each entry is a run-level summary (status, token usage, step count, and timing), not a node-by-node execution log.

To follow a run's node-level events, stream it instead:

- **A run you start**: use [Run Workflow](/en/api-reference/workflow-runs/run-workflow) in streaming mode, which emits `node_started` and `node_finished` as the run executes.
- **A run already in progress**: call [Stream Workflow Events](/en/api-reference/workflow-runs/stream-workflow-events) with `include_state_snapshot=true` to replay each executed node's status, then stream the rest.

A finished run's node-level logs aren't available through the Service API.

## Query parameters

- `keyword` string
- `status` 'succeeded' | 'failed' | 'stopped'
- `page` integer
- `limit` integer
- `created_at__before` string, date-time
- `created_at__after` string, date-time
- `created_by_end_user_session_id` string
- `created_by_account` string

## Response `200`

Successfully retrieved workflow logs.

- WorkflowLogsResponse
  - `page` integer — Current page number.
  - `limit` integer — Number of items per page.
  - `total` integer — Total number of log entries.
  - `has_more` boolean — Whether more pages are available.
  - `data` WorkflowLogItem[] — List of workflow log entries.
    - `id` string, uuid — Log entry ID.
    - `workflow_run` WorkflowRunSummary
      - `id` string, uuid — Workflow run ID.
      - `version` string — Workflow version identifier.
      - `status` string — Workflow execution status. `running` for in-progress executions, `succeeded` when completed successfully, `failed` when execution encountered an error, `stopped` when manually halted, `partial-succeeded` when some nodes succeeded but others failed, `paused` when awaiting human input.
      - `error` string, nullable — Error message if the workflow failed.
      - `elapsed_time` number, float — Total time elapsed in seconds.
      - `total_tokens` integer — Total tokens consumed.
      - `total_steps` integer — Total number of workflow steps executed.
      - `created_at` integer — Unix timestamp of when the workflow run was created.
      - `finished_at` integer, nullable — Unix timestamp of when the workflow run finished.
      - `exceptions_count` integer — Number of exceptions that occurred during execution.
      - `triggered_from` string — Source that triggered the workflow run. `app-run` for runs started from the app or API, `webhook` for runs started by a webhook trigger, `schedule` for runs started by a schedule trigger, `plugin` for runs started by an integration trigger.
    - `created_from` string — Source of the workflow run (e.g., `service-api`).
    - `created_by_role` string — Role of the creator (e.g., `end_user`, `account`).
    - `created_by_account` object, nullable — Account details if created by an admin user.
      - `id` string, uuid — Account ID.
      - `name` string — Account display name.
      - `email` string — Account email address.
    - `created_by_end_user` EndUserSummary
      - `id` string, uuid — End user ID.
      - `type` string — End user type.
      - `is_anonymous` boolean — Whether the end user is anonymous.
      - `session_id` string — Session identifier.
    - `created_at` integer — Unix timestamp of when the log entry was created.
    - `details` object, nullable — Additional details for the log entry.

## Other responses

- `400` — `invalid_param` : A query parameter is invalid, such as a `created_by_account` value matching no account, a malformed `created_at__before` or `created_at__after` timestamp, or an out-of-range `page`, `limit`, or `status` value.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)