List Workflow Executions | Browser Use Cloud Docs

Get paginated list of executions for a specific workflow.

Authentication

X-Browser-Use-API-Keystring

API Key authentication via header

Path Parameters

workflow_idstringRequiredformat: "uuid"

Query Parameters

pageSizeintegerOptional1-100Defaults to 10

pageNumberintegerOptional>=1Defaults to 1

statusenum or nullOptional

Status of workflow execution.

Attributes: PENDING: Execution has been created but not started RUNNING: Execution is currently in progress COMPLETED: Execution finished successfully FAILED: Execution failed with errors CANCELLED: Execution was cancelled by user

Allowed values:

workflowIdstring or nullOptionalformat: "uuid"

Response

Successful Response

itemslist of objects

List of executions for the current page

totalItemsinteger

Total number of items in the list

pageNumberinteger

Page number

pageSizeinteger

Number of items per page

1	import requests
2
3	url = "https://api.browser-use.com/api/v2/workflows/workflow_id/executions"
4
5	headers = {"X-Browser-Use-API-Key": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"items": [
3	{
4	"id": "string",
5	"workflowId": "string",
6	"status": "pending",
7	"createdAt": "2024-01-15T09:30:00Z",
8	"startedAt": "2024-01-15T09:30:00Z",
9	"finishedAt": "2024-01-15T09:30:00Z",
10	"timeTaken": 1.1,
11	"totalCost": "0",
12	"input": {},
13	"output": {},
14	"errors": {}
15	}
16	],
17	"totalItems": 1,
18	"pageNumber": 1,
19	"pageSize": 1
20	}

Authentication

Path Parameters

Query Parameters

Response

Errors