# Get All Systems

Retrieves all systems managed by Endpoint Central along with their patch health and scan.

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/allsystems`

## Request

### Request URL

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

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

### Scope

`DesktopCentralCloud.PatchMgmt.READ`

### Header

```text
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
```

### Request Parameters

#### Query Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `resid` | string | Optional | Filter for system with a resource id |
| `domainfilter` | string | Optional | Get domain list from api/1.4/desktop/serverproperties |
| `platformfilter` | string | Optional | Windows/Mac/Linux |
| `branchofficefilter` | string | Optional | Get branch office list from api/1.4/desktop/serverproperties |
| `customgroupfilter` | string | Optional | Get Custom Group list from api/1.4/desktop/serverproperties |
| `healthfilter` | integer | Optional | 0: Unknown — patch status is not available, 1: Healthy — system is up-to-date, 2: Vulnerable — system has missing patches, 3: Highly Vulnerable — system has critical or high-risk missing patches |
| `livestatusfilter` | integer | Optional | 1: Agent Live (agent is running), 2: Agent Down (agent is not responding) |
| `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 |  |

### Sample Request

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

## Response

### HTTP Code 200

Response body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| Response body | JSON Object |  |
| `Links` | JSON Object | Pagination links for next and previous pages |
| `messageResponse` | JSON Array | Array of system entries |
| `metadata` | JSON Object | Pagination metadata |
| `status` | string | Operation result: success |
| `totalPages` | string | Total number of pages available |
| `totalRecords` | string | Total number of records matching the query |

### Sample Response: HTTP 200

Paginated list of managed systems

```json
{
  "response_code": 200,
  "message_type": "allsystems",
  "message_response": {
    "allsystems": [
      {
        "branch_office_name": "Local Office",
        "scan_status": 228,
        "resource_health_status": 3,
        "agent_last_contact_time": 1553069591000,
        "critical_patch_count": 2,
        "domain_netbios_name": "DOMAIN",
        "ip_address": "192.168.1.100",
        "os_platform_name": "Windows",
        "installed_tp_patches": 9,
        "installed_ms_patches": 12,
        "important_patch_count": 2,
        "service_pack": "Windows 10 Version 1809 (x64)",
        "missing_ms_patches": 2,
        "resource_id": 301,
        "os_name": "Windows 10 Professional Edition (x64)",
        "missing_tp_patches": 3,
        "computer_live_status": 1,
        "resource_name": "COMPUTER-01",
        "last_scan_time": 1553073465582,
        "last_successful_scan": 1553073465582
      }
    ],
    "total": 97,
    "limit": 25,
    "page": 1
  },
  "message_version": "1.0",
  "status": "success"
}
```

## 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.