Skip to content
Browser Extensions/
List browser extensions

List browser extensions

Request

Retrieve a list of browser extension objects

Security
x-api-key
Query
extensionIdstring

Filter by the ID of the extension

employeeIdstring

Filter by an employee ID associated with this extension.

browserIdstring

Filter by a browserId associated with this extension.

deploymentModestring(DeploymentMode)

Filter by the deployment mode of the extension.

Enum:"MANAGED""DEVELOPMENT""MANUAL""SIDELOAD""OTHER"
permissionsArray of strings

Filter for browser extensions that have certain permissions.

hostPermissionsArray of strings

Filter for browser extensions that have certain host permission patterns.

enabledboolean

Filter for extension that are enabled or disabled.

limitinteger, [ 1 .. 500 ]

Used for pagination. Number of objects to return.

Default:500
offsetintegerdeprecated

Used for pagination. Number of objects to skip. Cannot be set when nextToken is also set.

nextTokenstring

Used for pagination. Token to be used for the next request. Cannot be set when offset is also set.

GET
/v1/browserExtensions
curl -i -X GET \
  https://api.pushsecurity.com/v1/browserExtensions \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
resultArray of objects(BrowserExtension)
pagingobject
Response
{
  "result": [
    {
      "id": "72d0347a-2663-4ef5-b1c5-df39163f1603",
      "extensionId": "gmbgaklkmjakoegficnlkhebmhkjfich",
      "employeeId": "72d0347a-2663-4ef5-b1c5-df39163f1603",
      "browserId": "72d0347a-2663-4ef5-b1c5-df39163f1603",
      "name": "Privacy Badger",
      "description": "Privacy Badger automatically learns to block invisible trackers.",
      "deploymentMode": "MANAGED",
      "permissions": [
        "activeTab",
        "contextMenus",
        "storage"
      ],
      "hostPermissions": [
        "https://*/*",
        "http://*/*"
      ],
      "version": "3.1.5.2",
      "versionName": "build rc2",
      "enabled": true,
      "disabledReason": "NEW_PERMISSION_REQUIRED",
      "updateUrl": "http://clients2.google.com/service/update2/crx",
      "homePageUrl": "http://www.eff.org/",
      "creationTimestamp": 1698064423,
      "lastUpdatedTimestamp": 1698064423
    }
  ],
  "paging": {
    "moreResults": true,
    "next": "501",
    "nextToken": "0b9972aa-fe8d-4095-82d3-2e13cf3cfd43"
  }
}