# List browser extensions

Retrieve a list of browser extension objects

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

## Query parameters:

  - `extensionId` (string)
    Filter by the ID of the extension

  - `employeeId` (string)
    Filter by an employee ID associated with this extension.

  - `browserId` (string)
    Filter by a browserId associated with this extension.

  - `deploymentMode` (string)
    Filter by the deployment mode of the extension.
    Enum: "MANAGED", "DEVELOPMENT", "MANUAL", "SIDELOAD", "OTHER"

  - `permissions` (array)
    Filter for browser extensions that have certain permissions.

  - `hostPermissions` (array)
    Filter for browser extensions that have certain host permission patterns.

  - `enabled` (boolean)
    Filter for extension that are enabled or disabled.

  - `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 ID of this browser extension record
    Example: "72d0347a-2663-4ef5-b1c5-df39163f1603"

  - `result.extensionId` (string)
    Static identifier for the extension.
    Example: "gmbgaklkmjakoegficnlkhebmhkjfich"

  - `result.employeeId` (string)
    Identifier of primary employee that this extension belongs to
    Example: "72d0347a-2663-4ef5-b1c5-df39163f1603"

  - `result.browserId` (string)
    Identifier of the employee's Push extension
    Example: "72d0347a-2663-4ef5-b1c5-df39163f1603"

  - `result.name` (string)
    Name of the browser extension
    Example: "Privacy Badger"

  - `result.description` (string)
    Description of the browser extension
    Example: "Privacy Badger automatically learns to block invisible trackers."

  - `result.deploymentMode` (string)
    Which method was used to install this extension
    Enum: "MANAGED", "DEVELOPMENT", "MANUAL", "SIDELOAD", "OTHER"

  - `result.permissions` (array)
    Permissions required by the browser extension
    Example: ["activeTab","contextMenus","storage"]

  - `result.hostPermissions` (array)
    Host permissions allow extensions to interact with the URLs matching these patterns.
    Example: ["https://*/*","http://*/*"]

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

  - `result.versionName` (string)
    Version number shown to the user
    Example: "build rc2"

  - `result.enabled` (boolean)
    Whether the browser extension is enabled
    Example: true

  - `result.disabledReason` (string)
    Reason why the browser extension was disabled
    Example: "NEW_PERMISSION_REQUIRED"

  - `result.updateUrl` (string)
    The URL where the browser extension gets updates from
    Example: "http://clients2.google.com/service/update2/crx"

  - `result.homePageUrl` (string)
    Link to the browser extensions home page
    Example: "http://www.eff.org/"

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

  - `result.lastUpdatedTimestamp` (integer)
    When the browser extension was last used by an employee, formatted as a UNIX timestamp (in seconds)
    Example: 1698064423

  - `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