# List Workflows

List all Workflows.

## Request

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

### Response

```json
{
  "data": [
    {
      "id": "wf_test_61UNwDso5RkJhsXt116TT0rUFzSQLefl99yAJBArIFXc",
      "object": "v2.extend.workflow",
      "created": "2026-03-24T16:57:16.660Z",
      "livemode": false,
      "status": "active",
      "title": "Cancel unpaid invoices",
      "triggers": [
        {
          "manual": {},
          "type": "manual"
        }
      ]
    },
    {
      "id": "wf_test_61UM4xxSHv971kVmM16TT0rUFzSQLefl99yAJBArI3Am",
      "object": "v2.extend.workflow",
      "created": "2026-03-19T13:53:09.987Z",
      "livemode": false,
      "status": "active",
      "title": "Send welcome email",
      "triggers": [
        {
          "event_trigger": {
            "events_from": [
              "@self"
            ],
            "type": "customer.created"
          },
          "type": "event_trigger"
        }
      ]
    }
  ],
  "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 Workflows, include only those with the specified status values. If not specified, all Workflows in active and inactive status are returned.
Possible enum values:
  - `active`
    This Workflow is active and ready to be invoked.

  - `archived`
    This Workflow has been archived, and cannot be invoked.

  - `draft`
    This Workflow has not been finalized, and cannot be invoked.

  - `inactive`
    This Workflow has been saved, but is temporarily paused, and cannot be invoked.

## Returns

## Response attributes

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

- `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.