List Tasks | Browser Use Cloud Docs

Get paginated list of AI agent tasks with optional filtering by session and status.

Authentication

X-Browser-Use-API-Keystring

API Key authentication via header

Query Parameters

pageSizeintegerOptional1-100Defaults to 10

pageNumberintegerOptional>=1Defaults to 1

sessionIdstring or nullOptionalformat: "uuid"

filterByenum or nullOptional

Enumeration of possible task execution states

Attributes: CREATED: Task has been created but not yet started. STARTED: Task has been started and is currently running. FINISHED: Task has finished and the agent has completed the task. STOPPED: Task execution has been manually stopped (cannot be resumed).

Allowed values:

afterdatetime or nullOptional

beforedatetime or nullOptional

Response

Successful Response

itemslist of objects

List of task views 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	"sessionId": "string",
6	"llm": "string",
7	"task": "string",
8	"status": "created",
9	"createdAt": "2024-01-15T09:30:00Z",
10	"startedAt": "2024-01-15T09:30:00Z",
11	"finishedAt": "2024-01-15T09:30:00Z",
12	"metadata": {},
13	"output": "string",
14	"browserUseVersion": "string",
15	"isSuccess": true,
16	"judgement": "string",
17	"judgeVerdict": true
18	}
19	],
20	"totalItems": 1,
21	"pageNumber": 1,
22	"pageSize": 1
23	}

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

Authentication

Query Parameters

Response

Errors