# Retrieve Applicable Patches Across Managed Systems

Retrieves all applicable patches across managed systems.

## Endpoint

`GET /dcapi/patch/reports/applicablePatches`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/patch/reports/applicablePatches`

### Scope

`PatchMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/patch/reports/applicablePatches \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP 200

Response Body: `application/json`

`JSON object`

- **data** (`array`): Array of report-specific data records
- **total** (`string`): Total number of records
- **page** (`string`): Current page number
- **pageLimit** (`string`): Records per page

### HTTP 500

Response Body: `application/json`

`JSON object`

- **error_code** (`string`): Error code: INTERNAL_ERROR for server-side failures
- **error_description** (`string`): Localized error description: dc.rest.api_internal_error

### Possible Response Codes

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

### Sample Response: HTTP 200

Applicable patches report

```json
{
  "total": 3921,
  "pageLimit": 25,
  "data": [
    {
      "patchName": "KB5034765",
      "severity": "Critical",
      "approvalStatus": "Approved",
      "patchId": 310521,
      "missingCount": 15,
      "installedCount": 85,
      "vendorName": "Microsoft",
      "platform": "Windows"
    }
  ],
  "page": 1
}
```

### Sample Response: HTTP 500

Server-side error

```json
{
  "error_description": "dc.rest.api_internal_error",
  "error_code": "INTERNAL_ERROR"
}
```

## Rate Limit

**Duration:** 1 minute | **Threshold:** 50 | **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.