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	{
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	}

1	curl https://api.browser-use.com/api/v2/workflows/workflow_id/executions \
2	-H "X-Browser-Use-API-Key: <apiKey>"

Authentication

Path Parameters

Query Parameters

Response

Errors