---
title: "Get advanced settings"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/sensor/get-advanced-settings.html
api_method: GET
api_endpoint: "/apicontroller/v1/sensor/advancedSettings"
api_url: "https://daas.digicert.com/apicontroller/v1/sensor/advancedSettings?sensorId=A79683A885D9967C&divisionId=677793&accountId=5153184"
---

**GET** `https://daas.digicert.com/apicontroller/v1/sensor/advancedSettings?sensorId=A79683A885D9967C&divisionId=677793&accountId=5153184`

Use this endpoint to get the advanced settings details available for the active sensors.

## Example requests and responses

## cURL

```bash
curl --location --request GET 'https://daas.digicert.com/apicontroller/v1/sensor/advancedSettings?sensorId=A79683A885D9967C&divisionId=677793&accountId=5153184' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{"updatePreference":"1","sensorName":"10.198.148.237_499","licenseKey":{{license_key}},"accountId":"5153184","divisionId":677793}'
```

## 200 OK

```json
{
    "error": null,
    "data": {
        "accountId": "5153184",
        "divisionIds": [
            677793
        ],
        "sensorId": "2A3C8D6874EADB1B",
        "sensorAdvancedSettings": {
            "heartbeatInterval": 120,
            "commPorts": {
                "hbPort": 8080,
                "dataCommPort": 8443,
                "empty": false
            },
            "portChangeInProgress": false,
            "programLogs": null
        }
    }
}
```

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt.</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>licenseKey</td>
<td>required</td>
<td>string</td>
<td>License key of the sensor to get the settings for.</td>
</tr>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>divisionId</td>
<td>required</td>
<td>integer</td>
<td>Division ID.</td>
</tr>
<tr>
<td>updatePreference</td>
<td>required</td>
<td>string</td>
<td>Sensor upgrade preference.<br><code>0</code> Automatic upgrade.<br><code>1</code> Manual upgrade.<br>Manually upgrade the sensor from the UI.</td>
</tr>
<tr>
<td>sensorName</td>
<td>required</td>
<td>string</td>
<td>Name of the sensor.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Includes error codes, if any.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with information about the filter results.</td>
</tr>
<tr>
<td>.. accountId</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>.. divisionIds</td>
<td>array</td>
<td>User's division IDs.</td>
</tr>
<tr>
<td>.. sensorId</td>
<td>string</td>
<td>Sensor license key ID.</td>
</tr>
<tr>
<td>.. sensorAdvancedSettings</td>
<td>array</td>
<td>Includes the advanced sensor settings.</td>
</tr>
<tr>
<td>.. .. heartbeatInterval</td>
<td>integer</td>
<td>Sensor heartbeat interval.</td>
</tr>
<tr>
<td>.. .. commPorts</td>
<td>array</td>
<td>Includes the port communication settings.</td>
</tr>
<tr>
<td>.. .. .. hbPort</td>
<td>integer</td>
<td>At this port, sensor will start the proxy server for agents.</td>
</tr>
<tr>
<td>.. .. .. dataCommPort</td>
<td>integer</td>
<td>SSL port for data communication from agent to sensor.</td>
</tr>
<tr>
<td>.. .. portChangeInProgress</td>
<td>boolean</td>
<td>If <code>true</code>, <code>hbPort</code> and <code>dataCommPort</code> changes are in progress.</td>
</tr>
<tr>
<td>.. .. programLogs</td>
<td>array</td>
<td>Changes the log level of sensor.</td>
</tr>
</tbody>
</table>