Public APIs - Retrieve Extensions for a Specific Device | Help Center

Retrieve Extensions for a Specific Device

Use this endpoint to get a detailed list of all browser extensions (Chrome, Safari, Firefox, and Edge) detected on a managed device.

Endpoint

GET https://api.swifteam.com/restful/organization/devices/:deviceId/extensions

EU Region: api.eu.swifteam.com

CURL Request Example

curl --location 'https://api.swifteam.com/restful/organization/devices/{deviceId}/extensions' \ --header 'Authorization: Bearer {YOUR_API_TOKEN}'

Parameters

Parameter	Type	Description
deviceId	Path	Required. The unique identifier of the device.
Authorization	Header	Required. Bearer token (Organization API Key).

Sample JSON Response

The response returns an extension object containing populated arrays for each browser category. If no extensions are found for a specific browser, an empty array is returned.

{
  "extension": {
    "chromeExtension": [
      {
        "name": "Swif Browser Extension",
        "identifier": "bpconcjcammlapcogcnnelfmaeghgmbi",
        "version": "1.2.4",
        "description": "Endpoint security and compliance tracking.",
        "enabled": true
      }
    ],
    "safariExtension": [],
    "firefoxAddon": [],
    "edgeExtension": [
      {
        "name": "Microsoft Defender for Endpoint",
        "identifier": "mfe...id",
        "version": "2.1.0",
        "enabled": true
      }
    ]
  }
}

Security and Access

Authentication: All requests must include a valid Organization API token in the Authorization header as a Bearer token.
Permissions: API keys are restricted to their own organization. The request will only succeed if the deviceId belongs to the organization associated with the API key.

Error Handling

If the request fails, the API returns a clear error message:

Invalid Token: 401 Unauthorized - "Unable to retrieve organization devices. Please verify your API key and try again."
Device Not Found/Access Denied: 404 Not Found or 403 Forbidden if the deviceId is incorrect or belongs to a different organization.