Sign in

v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB
Browser Pools

List browser pools

List browser pools in the resolved project.

get/browser_pools

Query parameters

limitinteger

Limit the number of browser pools to return.

offsetinteger

Offset the number of browser pools to return.

querystring

Case-insensitive substring match against browser pool name. IDs match by exact value.

namestring

Exact-match filter on browser pool name using the database collation. In production, matching is case- and accent-insensitive. During the default-project migration, unscoped requests prefer a concrete default-project browser pool over a legacy unscoped browser pool with the same name.

Response

List of browser pools

idstring required

Unique identifier for the browser pool

namestring

Browser pool name, if set

available_countinteger required

Number of browsers currently available in the pool

acquired_countinteger required

Number of browsers currently acquired from the pool

created_atstring date-time required

Timestamp when the browser pool was created

profile_idstring

Resolved profile ID the pool is attached to. Omitted when no profile is attached. Authoritative for programmatic consumers; the profile inside browser_pool_config reflects the configured selector (echoed as sent on create).

extension_idsstring[] required

Resolved extension IDs attached to the pool, in configured load order. Empty when no extensions are attached. Authoritative for programmatic consumers; the extensions inside browser_pool_config reflect the configured selector (echoed as sent on create).

Example response

[
  {
    "id": "iv25ujqf37x3j07dwoffegqr",
    "name": "my-pool",
    "available_count": 85,
    "acquired_count": 15,
    "browser_pool_config": {
      "size": 10,
      "name": "my-pool",
      "stealth": true,
      "refresh_on_profile_update": true,
      "viewport": {
        "width": 1280,
        "height": 800,
        "refresh_rate": 60
      },
      "kiosk_mode": true,
      "start_url": "https://example.com"
    },
    "profile_id": "iv25ujqf37x3j07dwoffegqr"
  }
]