Skip to main content
GET
/
v1
/
browser
/
sessions
List Browser Sessions
curl --request GET \
  --url https://api.driver.dev/v1/browser/sessions \
  --header 'Authorization: Bearer <token>'
{
  "page": 123,
  "pageSize": 123,
  "total": 123,
  "totalPages": 123,
  "sessions": [
    {
      "sessionId": "<string>",
      "servedBy": "<string>",
      "type": "hosted",
      "country": "<string>",
      "createdAt": "<string>",
      "stoppedAt": "<string>",
      "note": "<string>",
      "bandwidthBytes": 1
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Your Driver API key. Get one at https://app.driver.dev

Query Parameters

​
page
integer

The page number for pagination.

Required range: x > 0
Example:

1

​
pageSize
integer

The number of sessions per page.

Required range: x > 0
Example:

20

​
status
enum<string>

Filter sessions by status.

Available options:
starting,
active,
completed,
error
Example:

"active"

Response

Successfully retrieved list of browser sessions.

​
page
integer
required

The current page number.

​
pageSize
integer
required

The number of sessions per page.

​
total
integer
required

The total number of sessions.

​
totalPages
integer
required

The total number of pages.

​
sessions
object[]
required

Array of browser sessions.