List Tasks

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

Query parameters

pageSizeintegerOptional>=1<=100Defaults to 10

pageNumberintegerOptional>=1Defaults to 1

sessionIdstring or nullOptionalformat: "uuid"

filterByenum or nullOptional

Enumeration of possible task execution states

Attributes: STARTED: Task has been started and is currently running. PAUSED: Task execution has been temporarily paused (can be resumed) FINISHED: Task has finished and the agent has completed the task. STOPPED: Task execution has been manually stopped (cannot be resumed).

Allowed values:

afterstring or nullOptionalformat: "date-time"

beforestring or nullOptionalformat: "date-time"

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": "started",
9	"startedAt": "2024-01-15T09:30:00Z",
10	"isScheduled": true,
11	"finishedAt": "2024-01-15T09:30:00Z",
12	"metadata": {},
13	"output": "string",
14	"browserUseVersion": "string",
15	"isSuccess": true
16	}
17	],
18	"totalItems": 1,
19	"pageNumber": 1,
20	"pageSize": 1
21	}

Headers

Query parameters

Response

Errors

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