EDR Release 3.7.1 API

June 10, 2025

Before understanding the API release highlights, learn more about the API server URL to be used in your API requests by referring to the Know Your Qualys API Server URL section. For this API Release Notes, <qualys_base_url> is mentioned in the sample API requests.

We have implemented versioning for APIs. For more information on API versioning, refer to the Introducing API Versioning: A Strategic Upgrade for Enhanced Stability and Control for API Integrations blog.

New Feature: API Versioning Support

We’ve introduced API versioning to offer greater flexibility and long-term compatibility for clients integrating with our APIs.

Our APIs now support both:

Non-versioned endpoints (existing behavior).
Versioned endpoints: Currently, only v1 is available.

This enhancement allows you to explicitly specify the API version in the URL path.

API Versioning Documentation Sample

The following is a documentation sample illustrating how versioning has been added in this release. For complete information on the remaining APIs, see EDR API Online Help.

Fetch All Asset Details API Endpoint Structure

Non-Versioned

GET/ioc/asset/all

V1.0

GET/ioc/v1/asset/all

Sample Request for Fetch All Asset Details

Non-Versioned

Sample - Fetch Asset ListSample - Fetch Asset List

API Request

curl -X GET "<qualys_base_url>/ioc/asset/all" --header "accept: */*" -- header "Authorization: Bearer<token>"

Response

[
  {
    "hostName": "QBAS2",
    "lastReportedTime": "2024-12-09T14:36:08.605+0000",
    "edrFunctionalStatus": "Inactive",
    "productUpdateErrorCode": "0",
    "downloadPercent": 100,
    "avProfile": {
      "name": "test-12345",
      "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
      "status": "ASSIGNED"
    },
    "operatingSystem": "Microsoft Windows 8.1 Pro 6.3.9600 64-bit N/A Build 9600 UBR 20778",
    "platform": "Windows",
    "isAVUpToDate": false,
    "lastLoggedOnUser": "Administrator",
    "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
    "isEDREnabled": true,
    "interfaces": [
      {
        "macAddress": "00:X0:XX:0X:00:00",
        "ipAddress": "X0.1X.XX1.00",
        "interfaceName": "Intel(R) 82574L Gigabit Network Connection",
        "gatewayAddress": "XX.XX.X0X.X"
      }
    ],
    "avStatus": false,
    "antimalwareStatus": "Re-installing",
    "avStatusCategory": "In Progress",
    "tags": [
      {
        "name": "Test-TK",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "Cloud Agent",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "ProfileAssignTag",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "test45",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "TestMadhuri",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "Dynamic-test-EDR",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      }
    ],
    "timeStamp": "2025-02-25T06:21:43.899+0000",
    "avErrorCode": "Re-installing",
    "edrActivatedOnDate": "2024-12-04T07:25:09.000+0000"
  },
  {
    "hostName": "indra.centos7.edr.qualys.com",
    "avWorkflow": "UPDATE",
    "lastReportedTime": "2024-12-30T07:45:07.541+0000",
    "edrFunctionalStatus": "Inactive",
    "productUpdateErrorCode": "28",
    "downloadPercent": 100,
    "avProfile": {
      "name": "test-12345",
      "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
      "status": "ASSIGNED"
    },
    "operatingSystem": "CentOS Linux 7.5.1804",
    "isAVUpToDate": false,
    "platform": "Linux",
    "lastLoggedOnUser": "root",
    "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
    "isEDREnabled": false,
    "interfaces": [
      {
        "macAddress": "00:X0:XX:0X:00:00",
        "ipAddress": "X0.1X.XX1.00",
        "interfaceName": "ens192",
        "gatewayAddress": "XX.XX.X0X.X"
      }
    ],
    "avStatus": false,
    "antimalwareStatus": "Update Error",
    "avStatusCategory": "Update Failed",
    "tags": [
      {
        "name": "test45",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "ProfileAssignTag",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "Cloud Agent",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      }
    ],
    "timeStamp": "2025-02-25T06:21:44.970+0000",
    "avErrorCode": "DOWNLOAD_FAILURE",
    "edrActivatedOnDate": "2024-10-28T09:49:09.000+0000",
    "system": {
      "lastBoot": "2024-11-05 10:06:08",
      "timezone": "+05:30",
      "model": "VMware Virtual Platform",
      "manufacturer": "VMware, Inc."
    }
  }
]

V1.0

Sample - Fetch Asset ListSample - Fetch Asset List

API Request

curl -X GET "<qualys_base_url>/ioc/v1/asset/all" --header "accept: */*" -- header "Authorization: Bearer<token>"

Response

[
  {
    "hostName": "QBAS2",
    "lastReportedTime": "2024-12-09T14:36:08.605+0000",
    "edrFunctionalStatus": "Inactive",
    "productUpdateErrorCode": "0",
    "downloadPercent": 100,
    "avProfile": {
      "name": "test-12345",
      "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
      "status": "ASSIGNED"
    },
    "operatingSystem": "Microsoft Windows 8.1 Pro 6.3.9600 64-bit N/A Build 9600 UBR 20778",
    "platform": "Windows",
    "isAVUpToDate": false,
    "lastLoggedOnUser": "Administrator",
    "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
    "isEDREnabled": true,
    "interfaces": [
      {
        "macAddress": "00:X0:XX:0X:00:00",
        "ipAddress": "X0.1X.XX1.00",
        "interfaceName": "Intel(R) 82574L Gigabit Network Connection",
        "gatewayAddress": "XX.XX.X0X.X"
      }
    ],
    "avStatus": false,
    "antimalwareStatus": "Re-installing",
    "avStatusCategory": "In Progress",
    "tags": [
      {
        "name": "Test-TK",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "Cloud Agent",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "ProfileAssignTag",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "test45",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "TestMadhuri",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "Dynamic-test-EDR",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      }
    ],
    "timeStamp": "2025-02-25T06:21:43.899+0000",
    "avErrorCode": "Re-installing",
    "edrActivatedOnDate": "2024-12-04T07:25:09.000+0000"
  },
  {
    "hostName": "indra.centos7.edr.qualys.com",
    "avWorkflow": "UPDATE",
    "lastReportedTime": "2024-12-30T07:45:07.541+0000",
    "edrFunctionalStatus": "Inactive",
    "productUpdateErrorCode": "28",
    "downloadPercent": 100,
    "avProfile": {
      "name": "test-12345",
      "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
      "status": "ASSIGNED"
    },
    "operatingSystem": "CentOS Linux 7.5.1804",
    "isAVUpToDate": false,
    "platform": "Linux",
    "lastLoggedOnUser": "root",
    "id": "XXX8a87X-XXbb-4XX9-XX74-XXX08f6XX54X",
    "isEDREnabled": false,
    "interfaces": [
      {
        "macAddress": "00:X0:XX:0X:00:00",
        "ipAddress": "X0.1X.XX1.00",
        "interfaceName": "ens192",
        "gatewayAddress": "XX.XX.X0X.X"
      }
    ],
    "avStatus": false,
    "antimalwareStatus": "Update Error",
    "avStatusCategory": "Update Failed",
    "tags": [
      {
        "name": "test45",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "ProfileAssignTag",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      },
      {
        "name": "Cloud Agent",
        "uuid": "XXX676fX-cXX8-XX32-bfXX-XXX8XbcXXX1b"
      }
    ],
    "timeStamp": "2025-02-25T06:21:44.970+0000",
    "avErrorCode": "DOWNLOAD_FAILURE",
    "edrActivatedOnDate": "2024-10-28T09:49:09.000+0000",
    "system": {
      "lastBoot": "2024-11-05 10:06:08",
      "timezone": "+05:30",
      "model": "VMware Virtual Platform",
      "manufacturer": "VMware, Inc."
    }
  }
]

Both versions currently return the same response, and functionality remains unchanged.

Backward Compatibility

All existing integrations using non-versioned endpoints will continue to function without modification.
The versioned endpoint is functionally identical to the non-versioned endpoint in this release.

At this stage, versioning does not introduce any changes in behavior, request parameters, or response structure.
Future API enhancements may be introduced under newer versions to ensure backward compatibility.

Correction to API Documentation

The internal 'Asset Alert' API was mistakenly marked as public and included in the API Online Help and EDR Release 3.6.0 API. This API is not intended for external use and is now removed from public documentation.