> ## Documentation Index > Fetch the complete documentation index at: https://docs.summation.com/llms.txt > Use this file to discover all available pages before exploring further. # List workflow runs > List a workflow's runs, newest first, each with its per-step or per-node detail so you can see where a run stopped and what it produced. ## OpenAPI ````yaml https://api.summation.com/openapi.json get /v1/workflows/{workflow_id}/runs openapi: 3.1.0 info: title: summation-api public API version: 0.1.0 servers: [] security: [] tags: - name: Auth description: Machine authentication for API clients. - name: Tenant description: Organization and tenant context resolved by summation-api. - name: Projects description: Project resources. - name: Conversations description: Conversation and message resources. - name: Reports description: Report resources and report operations. - name: Runs description: Project run history and execution status. - name: Playbooks description: Playbook resources. - name: Files description: Project file resources. - name: Catalog Entries description: Project-scoped data asset attachments. - name: Data Connectors description: Reusable external data source connections. - name: App Connectors description: External app connectors whose tools the agent can use during chat. - name: Tables description: Canonical table metadata and catalog. - name: Views description: Canonical Summation view metadata and catalog. - name: Query Executions description: Read-only SQL query execution. - name: Grid description: Materialized grid status, sync, and lineage. - name: Schedules description: Schedule and schedule run inspection. - name: Workflows description: >- Workflows: what they run, when they run, and where their output is delivered. - name: Verification Tests description: >- Administrative custom verification-test definitions, overlays, and effective-set previews. paths: /v1/workflows/{workflow_id}/runs: get: tags: - Workflows summary: List workflow runs description: >- List a workflow's runs, newest first, each with its per-step or per-node detail so you can see where a run stopped and what it produced. operationId: list_workflow_runs parameters: - name: workflow_id in: path required: true schema: type: string title: Workflow Id - name: page_token in: query required: false schema: anyOf: - type: string - type: 'null' description: Token from a previous page's next_page_token. title: Page Token description: Token from a previous page's next_page_token. - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Runs per page, 1 to 100. default: 5 title: Page Size description: Runs per page, 1 to 100. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WorkflowRunListResponse' '400': description: Invalid request or unsupported option. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '401': description: Missing, invalid, or expired credentials. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '403': description: Authenticated but missing the required scope. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '404': description: Resource not found or not accessible. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '500': description: Internal server error. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '503': description: >- The workflows service is temporarily unavailable. Retry this request shortly. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' security: - SummationMachineAuth: - agent:read components: schemas: WorkflowRunListResponse: properties: data: $ref: '#/components/schemas/WorkflowRunListData' type: object required: - data title: WorkflowRunListResponse ProblemError: description: >- Public error envelope (RFC 7807 ``application/problem+json``). Mirrors the body produced by :func:`api_error`. Declaring it in the contract lets generated clients type error handling instead of guessing. properties: type: description: URI reference identifying the problem type. title: Type type: string title: description: Short, human-readable summary of the problem type. title: Title type: string status: description: HTTP status code. title: Status type: integer detail: description: Human-readable explanation specific to this occurrence. title: Detail type: string code: description: Stable, machine-readable error code. title: Code type: string request_id: description: Correlation id, echoed in the x-request-id header. title: Request Id type: string required: - type - title - status - detail - code - request_id title: ProblemError type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError WorkflowRunListData: properties: runs: items: $ref: '#/components/schemas/WorkflowRun' type: array title: Runs description: Newest first. nextPageToken: anyOf: - type: string - type: 'null' title: Nextpagetoken type: object required: - runs title: WorkflowRunListData ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError WorkflowRun: properties: id: type: string title: Id workflowId: type: string title: Workflowid workflowVersionId: type: string title: Workflowversionid description: The activated version this run executed, when the workflow had one. triggerId: type: string title: Triggerid description: The schedule that started the run; empty for an on-demand run. triggerType: type: string title: Triggertype status: type: string title: Status description: >- One of pending, dispatched, running, succeeded, failed, canceled, timed_out, completed_with_errors, unknown. businessOutcome: anyOf: - type: string - type: 'null' title: Businessoutcome description: >- The run's verdict where it has one beyond success: no_action means the workflow ran and deliberately delivered nothing, for example because a data freshness gate stopped it. params: additionalProperties: true type: object title: Params description: The parameter values this run resolved to. errorReason: type: string title: Errorreason description: >- Why the run did not complete, in product terms. Empty for a run that succeeded. steps: items: $ref: '#/components/schemas/WorkflowRunStep' type: array title: Steps description: Step detail, for legacy workflows. nodes: items: $ref: '#/components/schemas/WorkflowRunNode' type: array title: Nodes description: Per-node detail, for graph workflows. createdAt: anyOf: - type: string - type: 'null' title: Createdat dispatchedAt: anyOf: - type: string - type: 'null' title: Dispatchedat completedAt: anyOf: - type: string - type: 'null' title: Completedat type: object required: - id - workflowId - workflowVersionId - triggerId - triggerType - status - params - errorReason - steps - nodes title: WorkflowRun WorkflowRunStep: properties: id: type: string title: Id stepId: type: string title: Stepid type: type: string title: Type description: playbook, email_delivery, slack_delivery, or unknown. status: type: string title: Status description: pending, running, succeeded, failed, skipped, canceled, or unknown. detail: additionalProperties: true type: object title: Detail description: >- What the step delivered or failed on, as a curated set of fields: outcome, errorReason, skipReason, and the delivery counts (recipientCount, deliveredCount, suppressedCount, failedRecipientCount, targetCount, failedTargetCount, attachmentCount, linkCount). A field is absent when the step reported nothing for it, and an empty object means the step reported nothing at all. createdAt: anyOf: - type: string - type: 'null' title: Createdat updatedAt: anyOf: - type: string - type: 'null' title: Updatedat type: object required: - id - stepId - type - status - detail title: WorkflowRunStep WorkflowRunNode: properties: id: type: string title: Id nodeKey: type: string title: Nodekey description: The node's key in the frozen graph this run executed. nodeType: type: string title: Nodetype sequence: type: integer title: Sequence status: type: string title: Status description: pending, running, succeeded, failed, skipped, canceled, or unknown. outcome: type: string title: Outcome description: How the node finished, beyond its status. Empty while it is running. attempt: type: integer title: Attempt errorReason: type: string title: Errorreason skipReason: type: string title: Skipreason decidedByNodeKey: type: string title: Decidedbynodekey description: The gate that skipped this node, when one did. result: additionalProperties: true type: object title: Result description: What the node produced. startedAt: anyOf: - type: string - type: 'null' title: Startedat completedAt: anyOf: - type: string - type: 'null' title: Completedat type: object required: - id - nodeKey - nodeType - sequence - status - outcome - attempt - errorReason - skipReason - decidedByNodeKey - result title: WorkflowRunNode securitySchemes: SummationMachineAuth: type: oauth2 flows: clientCredentials: scopes: agent:read: agent:read agent:write: agent:write tokenUrl: /v1/auth/m2m/token ````