Browserbase

List sessions

List sessions

GET /browserbase/v1/sessions● Supported

Browserbase

Request parameters

  • statusstring可选
    取值 PENDINGRUNNINGERRORTIMED_OUTCOMPLETED
  • qstring可选

    Query sessions by user metadata. See [Querying Sessions by User Metadata](/features/sessions#querying-sessions-by-user-metadata) for the schema of this query.

Returns

200

Only the capabilities in the service guide are available; some upstream options are unavailable.

Errors contain statusCode, error and message; the native API adds code. The request ID is in X-Request-Id. Errors

Connection guide

Proxies, stealth options, extensions and Selenium are unavailable. region and solveCaptchas are accepted but ignored; region selection and CAPTCHA solving are not provided.

Response

HTTP 200

The request has succeeded.

application/json

NameTypeDescription
[].idstring
[].createdAtstring
[].updatedAtstring
[].projectIdstringThe Project ID linked to the Session.
[].startedAtstring
[].endedAtstring
[].expiresAtstring
[].statusstring
[].proxyBytesintegerBytes used via the Proxy
[].keepAlivebooleanIndicates if the Session was created to be kept alive upon disconnections
[].contextIdstringOptional. The Context linked to the Session.
[].regionstringThe region where the Session is running.
[].userMetadataobjectArbitrary user metadata to attach to the session. To learn more about user metadata, see User Metadata.