# 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://{server-hostname}:8383/api/1.4/patch/allsystems`

### Scope

`PatchMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

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

## Response

### HTTP Code 200

Response body: `application/json`

- 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"
}
```

## Possible Response Codes

- **200** (`HTTP code`)

## Rate Limits

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