# List browsers

Retrieve a list of browser objects

Endpoint: GET /v1/browsers
Version: v1
Security: x-api-key

## Query parameters:

  - `email` (string)
    Filter by email address. Accepts partial email addresses for wildcard searches.

  - `employeeId` (string)
    Filter by employee ID.

  - `browser` (any)
    Filter by browser name.
    Enum: "CHROME", "FIREFOX", "EDGE", "SAFARI", "OPERA", "BRAVE", "ARC", "ISLAND", "PRISMA_ACCESS", "UNKNOWN"

  - `os` (any)
    Filter by operating system name.
    Enum: "MACOS", "WINDOWS", "LINUX", "CHROME_OS", "IOS", "ANDROID", "UNKNOWN"

  - `lastOnlineTimestampAfter` (integer)
    Filter by when the browser was last used by an employee - start time. This is a UNIX timestamp (in seconds).

  - `lastOnlineTimestampBefore` (integer)
    Filter by when the browser was last used by an employee - end time. This is a UNIX timestamp (in seconds).

  - `limit` (integer)
    Used for pagination. Number of objects to return.

  - `nextToken` (string)
    Used for pagination. Token to be used for the next request. Cannot be set when offset is also set.

  - `offset` (integer)
    Used for pagination. Number of objects to skip. Cannot be set when nextToken is also set.

## Response 200 fields (application/json):

  - `result` (array)

  - `result.id` (string)
    Unique identifier for the browser
    Example: "1852b6ab-0cca-4c8d-8f14-4905497504ec"

  - `result.employeeId` (string)
    Unique identifier for the employee
    Example: "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0"

  - `result.email` (string)
    Email address of the employee
    Example: "john.hill@example.com"

  - `result.version` (string)
    Version of the browser
    Example: "125.0.0.0"

  - `result.tokenType` (string)
    Type of enrollment token used
    Enum: "INDIVIDUAL", "TEAM", "LANDING_PAGE"

  - `result.isActive` (boolean)
    Whether the browser extension is used by a licensed employee
    Example: true

  - `result.browser` (any)
    The browser used by the employee
    Enum: "CHROME", "FIREFOX", "EDGE", "SAFARI", "OPERA", "BRAVE", "ARC", "ISLAND", "PRISMA_ACCESS", "UNKNOWN"

  - `result.os` (any)
    The OS used by the employee
    Enum: "MACOS", "WINDOWS", "LINUX", "CHROME_OS", "IOS", "ANDROID", "UNKNOWN"

  - `result.extensionVersion` (string)
    Version of the Push extension
    Example: "1.66.17"

  - `result.language` (string)
    The browser language
    Example: "en-US"

  - `result.profileEmail` (string)
    The email address of the signed in browser profile
    Example: "john.hill@example.com"

  - `result.profileSyncEnabled` (boolean)
    Whether synchronisation is enabled on the browser profile
    Example: true

  - `result.creationTimestamp` (integer)
    When this browser object was created, formatted as a UNIX timestamp (in seconds)
    Example: 1698669223

  - `result.lastOnlineTimestamp` (integer)
    When this browser was last seen, formatted as a UNIX timestamp (in seconds)
    Example: 1716290202

  - `paging` (object)

  - `paging.moreResults` (boolean)
    Whether there are more results available
    Example: true

  - `paging.nextToken` (string,null)
    Start of the next page that can be used as the nextToken for the next request.
    Example: "0b9972aa-fe8d-4095-82d3-2e13cf3cfd43"

  - `paging.next` (string,null)
    Start of the next page that can be used as the offset for the next request
    Example: "501"


## Response 400 fields