Skip to content

Sandboxes · 3 November 2026

Browserbase session list filters on Browsers

GET /compat/browserbase/v1/sessions (sessions.list in Browserbase's SDK) accepts status (PENDING, RUNNING, COMPLETED or ERROR) and q in Browserbase's metadata query form, user_metadata['key']:'value', and returns only the sessions that match both. A session whose browser is still starting now reports PENDING instead of RUNNING. A q in any other form, including a nested path such as user_metadata['a']['b']:'value', returns 400: session metadata on Browsers holds only string values at the top level.

Same day.

Cut your cloud billby 75%.

No card to start. Billed by the second after.

Start free, no card