--- title: List of workflow instances --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Workflows](https://developers.cloudflare.com/api/python/resources/workflows) [Instances](https://developers.cloudflare.com/api/python/resources/workflows/subresources/instances) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List of workflow instances workflows.instances.list(strworkflow\_name, InstanceListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[InstanceListResponse]()] GET/accounts/{account\_id}/workflows/{workflow\_name}/instances Lists all instances of a workflow with their execution status. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `Workers Tail Read``Workers Scripts Write``Workers Scripts Read` ##### ParametersExpand Collapse account\_id: str [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) workflow\_name: str maxLength64 minLength1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20workflow_name%20%3E%20(schema)>) cursor: Optional\[str] Opaque token for cursor-based pagination. Mutually exclusive with `page`. [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20cursor%20%3E%20(schema)>) date\_end: Optional\[Union\[str, datetime]] Accepts ISO 8601 with no timezone offsets and in UTC. formatdate-time [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20date_end%20%3E%20(schema)>) date\_start: Optional\[Union\[str, datetime]] Accepts ISO 8601 with no timezone offsets and in UTC. formatdate-time [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20date_start%20%3E%20(schema)>)

direction: Optional\[Literal\["asc", "desc"]] Defines the direction for cursor-based pagination.

One of the following: "asc" Link to this property "desc" Link to this property

[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) Deprecatedpage: Optional\[float] Deprecated: use `cursor` for pagination instead. minimum1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[float] maximum100 minimum1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)

status: Optional\[Literal\["queued", "running", "paused", 6 more]]

One of the following: "queued" Link to this property "running" Link to this property "paused" Link to this property "errored" Link to this property "terminated" Link to this property "complete" Link to this property "waitingForPause" Link to this property "waiting" Link to this property "rollingBack" Link to this property

[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class InstanceListResponse: …

id: str maxLength100 minLength1 Link to this property created\_on: datetime formatdate-time Link to this property ended\_on: Optional\[datetime] formatdate-time Link to this property modified\_on: datetime formatdate-time Link to this property started\_on: Optional\[datetime] formatdate-time Link to this property

status: Literal\["queued", "running", "paused", 6 more]

Link to this property version\_id: str formatuuid Link to this property workflow\_id: str formatuuid Link to this property

trigger\_source: Optional\[Literal\["unknown", "api", "binding", 2 more]]

One of the following: "unknown" Link to this property "api" Link to this property "binding" Link to this property "event" Link to this property "cron" Link to this property

Link to this property

[Link to this property](<#(resource)%20workflows.instances%20%3E%20(model)%20instance_list_response%20%3E%20(schema)>) ### List of workflow instances Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.workflows.instances.list( workflow_name="x", account_id="account_id", ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": [ { "id": "x", "created_on": "2019-12-27T18:11:19.117Z", "ended_on": "2019-12-27T18:11:19.117Z", "modified_on": "2019-12-27T18:11:19.117Z", "started_on": "2019-12-27T18:11:19.117Z", "status": "queued", "version_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "trigger_source": "unknown" } ], "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": [ { "id": "x", "created_on": "2019-12-27T18:11:19.117Z", "ended_on": "2019-12-27T18:11:19.117Z", "modified_on": "2019-12-27T18:11:19.117Z", "started_on": "2019-12-27T18:11:19.117Z", "status": "queued", "version_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "trigger_source": "unknown" } ], "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ```