---
title: "List all Workflow Runs"
method: GET
path: "/workflow-runs"
tags: ["workflows"]
---

# List all Workflow Runs

`GET /workflow-runs`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/workflow-runs`
- Auth: HTTP bearer

Returns a list of your environment's workflow runs. Results are returned in reverse chronological order, with the most recently created objects first.

## Query parameters

- `page` WorkflowRunsGetParametersPage
  - `after` string: Object ID for pagination cursor
  - `before` string: Object ID for pagination cursor
  - `size` number, double: Limit on the number of objects returned
- `fields` object
- `filter` WorkflowRunsGetParametersFilter
  - `status` string: Filter workflow runs by workflow id

## Headers

- `Key-Inflection` 'camel' | 'kebab' | 'snake'
- `Idempotency-Key` string
- `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

## Response `200`

This endpoint returns a Workflow Run object.

- WorkflowsListAllWorkflowRunsResponse200
  - `data` WorkflowRun[], required: An array of Workflow Runs
    - `id` string
    - `attributes` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunAttributes
      - `completed-at` string, date-time, nullable
      - `created-at` string, date-time
      - `status` string
    - `relationships` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationships
      - `creator` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsCreator
        - `data` union
          - InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsCreatorData0
            - `type` 'administrator'
            - `id` string
          - InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsCreatorData1
            - `type` 'user'
            - `id` string
          - InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsCreatorData2
            - `type` 'event'
            - `id` string
          - InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsCreatorData3
            - `type` 'scheduled-run'
            - `id` string
      - `workflow` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsWorkflow
        - `data` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsWorkflowData
          - `type` 'workflow'
          - `id` string
      - `workflow-version` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsWorkflowVersion
        - `data` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunRelationshipsWorkflowVersionData
          - `type` 'workflow-version'
          - `id` string
    - `meta` InquiryIncludedObjectsItemsDiscriminatorMappingWorkflowRunMeta
      - `processing-time-seconds` number, double, nullable
  - `links` WorkflowRunsGetResponsesContentApplicationJsonSchemaLinks, required
    - `next` string, nullable, required
    - `prev` string, nullable, required

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

[API](https://skmtc.dev/withpersona/apis/withpersona-4.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-4/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-4/revisions/2eddd7dae374?raw)