# Retrieve Patch Deployment

Retrieves all patch deployment configurations along with their execution status.

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/viewconfig`

## Request URL

`https://{serverurl}/api/1.4/patch/viewconfig`

[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)

## Scope

`DesktopCentralCloud.PatchMgmt.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Query Parameters

- **searchvalue** `string` *(Optional)*
- **searchcolumn** `string` *(Optional)*
- **searchtype** `string` *(Optional)*
- **sortorder** `string` *(Optional)*
- **orderby** `string` *(Optional)*
- **pagelimit** `string` *(Optional)*: Number of records per page.
- **page** `integer` *(Optional)*: Current page number for pagination.
- **customerid** `long` *(Optional)*
- **configname** `string` *(Optional)*
- **configstatusfilter** `string` *(Optional)*: InProgress Draft,Executed,Suspended,Deployed,RetryInProgress,Expired
- **viewtypefilter** `string` *(Optional)*
- **configtypefilter** `integer` *(Optional)*
- **platformfilter** `string` *(Optional)*: Windows/Mac/Linux

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/api/1.4/patch/viewconfig \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

- `JSON Object`
  - **message_type** `string`: Value: viewconfig
  - **message_response** `JSON Object`: Paginated deployment configurations data
  - **message_version** `string`: API version: 1.0
  - **status** `string`: Operation status: success
  - **response_code** `string`: Response code: 200

## Sample Response: HTTP 200

Paginated list of deployment configurations with status

```json
{
  "response_code": 200,
  "message_type": "viewconfig",
  "message_response": {
    "viewconfig": [
      {
        "statusimage": "images/status_executedfailed.gif",
        "collection.collection_name": "Peazip x64 - narun-win10",
        "collectionstatussummary.retry_inprogress_count": 0,
        "collectionstatussummary.total_target_count": 1,
        "collectionstatus.status": 15,
        "collectionstatussummary.not_applicable_count": 0,
        "statuslabel": "dc.db.config.status.draft_download_failed",
        "collectionstatussummary.yet_to_apply_count": 1,
        "os_platform_name": "Windows",
        "collection.modified_time": 1552902864870,
        "collection.is_deleted": false,
        "collection.collection_id": 23708,
        "collectionstatussummary.failed_count": 0,
        "collection.is_single_config": true,
        "configurationparams.label": "dc.conf.conf_param.Install_Patches",
        "collectionstatussummary.success_count": 0,
        "first_name": "admin",
        "collection.platform_id": 1
      }
    ],
    "total": 284,
    "limit": 25,
    "page": 1
  },
  "message_version": "1.0",
  "status": "success"
}
```

![](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.