API Referencev2 API (Current)Browsers

Get Browser Session

Get detailed browser session information including status and URLs.

Path parameters

session_idstringRequiredformat: "uuid"

Headers

X-Browser-Use-API-KeystringRequired

Response

Successful Response
idstringformat: "uuid"
Unique identifier for the session
statusenum

Current status of the session (active/stopped)

Allowed values:
startedAtstringformat: "date-time"
Timestamp when the session was created and started
liveUrlstring or null

URL where the browser can be viewed live in real-time

cdpUrlstring or null
Chrome DevTools Protocol URL for browser automation
finishedAtstring or nullformat: "date-time"

Timestamp when the session was stopped (None if still active)

Errors