# List Workflow Runs

List all Workflow Runs.

## Request

```curl
curl https://api.stripe.com/v2/extend/workflow_runs \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-04-22.preview"
```

### Response

```json
{
  "data": [
    {
      "id": "wfrun_test_61UTL7vuMHzp5fHTd16TT0rUFzSQLefl99yAJBArITFo",
      "object": "v2.extend.workflow_run",
      "created": "2026-04-08T14:33:27.076Z",
      "status": "succeeded",
      "status_details": null,
      "status_transitions": {
        "failed_at": null,
        "started_at": "2026-04-08T14:33:27.335Z",
        "succeeded_at": "2026-04-08T14:33:29.177Z"
      },
      "trigger": {
        "event_trigger": {
          "id": "evt_1TJxAYHa3TtWqyXkmZHWuTlk",
          "context": "acct_1Nv0FGQ9RKHgCVdK",
          "type": "customer.created"
        },
        "type": "event_trigger"
      },
      "workflow": "wf_test_61UNwDso5RkJhsXt116TT0rUFzSQLefl99yAJBArIFXc",
      "livemode": false
    },
    {
      "id": "wfrun_test_61UTL8xvNHzp5fHTd16TT0rUFzSQLefl99yAJBArIUGp",
      "object": "v2.extend.workflow_run",
      "created": "2026-04-08T15:10:42.531Z",
      "status": "succeeded",
      "status_details": null,
      "status_transitions": {
        "failed_at": null,
        "started_at": "2026-04-08T15:10:42.718Z",
        "succeeded_at": "2026-04-08T15:10:44.892Z"
      },
      "trigger": {
        "event_trigger": {
          "id": "evt_1TJxBZHa3TtWqyXkpQRWvUml",
          "context": "acct_1Nv0FGQ9RKHgCVdK",
          "type": "customer.created"
        },
        "type": "event_trigger"
      },
      "workflow": "wf_test_61UNwDso5RkJhsXt116TT0rUFzSQLefl99yAJBArIFXc",
      "livemode": false
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}
```

## Parameters

- `limit` (integer, optional)
  Restrict page size to no more than this number.

- `page` (string, optional)
  Token of the current page in the list request.

- `status` (array of enums, optional)
  When retrieving Workflow Runs, include only those with the specified status values. If not specified, all Runs are returned.
Possible enum values:
  - `failed`
    This Workflow Run has terminated because of a failure.

  - `started`
    This Workflow Run is actively executing.

  - `succeeded`
    This Workflow Run has progressed to a successful completion.

- `workflow` (array of strings, optional)
  When retrieving Workflow Runs, include only those associated with the Workflows specified. If not specified, all Runs are returned.

## Returns

## Response attributes

- [`data`](https://docs.stripe.com/api/v2/extend/workflow-runs/list.md?query=data&api-version=2026-04-22.preview) (array of objects)
  One page of retrieved Workflow Runs.

- `next_page_url` (string, nullable)
  URL to fetch the next page of the list. If there are no more pages, the value is null.

- `previous_page_url` (string, nullable)
  URL to fetch the previous page of the list. If there are no previous pages, the value is null.