API ReferenceLatest API (v2)Sessions

List Sessions

Get paginated list of AI agent sessions with optional status filtering.

Authentication

X-Browser-Use-API-Keystring
API Key authentication via header

Query parameters

pageSizeintegerOptional1-100Defaults to 10
pageNumberintegerOptional>=1Defaults to 1
filterByenum or nullOptional

Enumeration of possible agent session states

Attributes: ACTIVE: Agent session is currently active and running STOPPED: Agent session has been stopped and is no longer active

Allowed values:

Response

Successful Response
itemslist of objects
List of session views for the current page
totalItemsinteger
Total number of items in the list
pageNumberinteger
Page number
pageSizeinteger
Number of items per page

Errors