# Fetches the list of software not yet enabled for auto-update

Retrieves all software entries from the PPM crawler database that are eligible for auto-update but not yet enabled. Returns counts per platform and detailed software information.

## Endpoints

`GET /dcapi/swDeployment/autoUpdateSWList`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/swDeployment/autoUpdateSWList`

### Scope

`SWDeployment.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** (`string`, Mandatory): `application/autoUpdateSWList.v1+json`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/swDeployment/autoUpdateSWList \
  --header 'Accept: application/autoUpdateSWList.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — `application/json`

- `JSON Object`
  - **WindowsSWCount** (`integer`): Number of Windows software eligible for auto-update
  - **MacSWCount** (`integer`): Number of Mac software eligible for auto-update
  - **SWDetails** (`JSON Array`): Array of software entries eligible for auto-update

### Sample Response: HTTP 200

Eligible software across platforms

```json
{
  "MacSWCount": 1,
  "SWDetails": [
    {
      "swName": "Google Chrome",
      "swID": 2001,
      "vendorName": "Google LLC",
      "platForm": 1
    },
    {
      "swName": "VLC Media Player",
      "swID": 2003,
      "vendorName": "VideoLAN",
      "platForm": 4
    }
  ],
  "WindowsSWCount": 1
}
```

### HTTP Code 500

#### Response Body — `application/json`

- `JSON Object`
  - **errorCode** (`string`): `INTERNAL_ERROR` for general failures, `SW_INTERNAL_ERROR` for software deployment internal errors
  - **errorMessage** (`string`): Internal server error with details about the template/auto-update operation failure

### Sample Response: HTTP 500

Server error

```json
{
  "errorMessage": "Internal Server Error",
  "errorCode": "INTERNAL_ERROR"
}
```

### Possible Response Codes

- **200**: HTTP code
- **500**: HTTP code

## API Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration — Time window for the threshold.  
Threshold — Number of API calls allowed within the specified duration.  
Lock Period — Wait time before consecutive API requests.