Skip to main content
GET
/
v1
/
browsers
List Sessions
curl --request GET \
  --url https://api.example.com/v1/browsers/
[
  {
    "browser_id": "0beda061-c829-4723-b6da-84b86c35ed7e",
    "contexts": [],
    "execution_id": "exc-4851be7b-a9d9-482c-bb73-92c110894f40",
    "grpc_port": 39525,
    "private_ip": "10.202.0.14",
    "public_ip": "34.162.232.126",
    "state": "idle"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.rustybrowser.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Description

Returns all currently active browsers. Rusty Cloud users see only their own sessions; open source returns all browsers on the host.

​
Authentication

Authorization: Bearer YOUR_API_KEY
Self-hosted open source deployments do not require authentication.

​
Response

Returns a flat array of browser objects.
​
[].browser_id
string
Internal browser UUID.
​
[].execution_id
string
The browser ID used in command endpoints.
​
[].contexts
array
List of open contexts on this browser.
​
[].state
string
Current state of the browser. e.g. idle, busy.
​
[].grpc_port
integer
Internal gRPC port.
​
[].private_ip
string
Internal IP address.
​
[].public_ip
string
Public IP address of the browser node.

​
Example

curl https://your-host/browsers/

[
  {
    "browser_id": "0beda061-c829-4723-b6da-84b86c35ed7e",
    "contexts": [],
    "execution_id": "exc-4851be7b-a9d9-482c-bb73-92c110894f40",
    "grpc_port": 39525,
    "private_ip": "10.202.0.14",
    "public_ip": "34.162.232.126",
    "state": "idle"
  }
]