# Retrieve Legacy Windows End-of-Life Systems

Retrieves systems running legacy Windows versions (e.g., Windows 7, Server 2008) that have reached end-of-life.

## Endpoints

**GET** `/dcapi/patch/reports/WinLegacyEoLSystemsView`

## Request URL

```
https://{serverurl}/dcapi/patch/reports/WinLegacyEoLSystemsView
```

`{serverurl}` → https://www.manageengine.com/products/desktop-central/oauth-authentication-endpoint-domain.html

## Scope

```
DesktopCentralCloud.PatchMgmt.READ
```

## Header

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

## Request Parameters

### Query Parameters

- **pageLimit** *(integer, optional)*  
  Number of records per page (default 25)

- **page** *(integer, optional)*  
  Page number to retrieve (1-based)

- **searchColumn** *(string, optional)*  
  Column name to search within

- **searchValue** *(string, optional)*  
  Value to search for in the specified column

- **domain** *(string, optional)*  
  Domain name filter

- **branchOffice** *(string, optional)*  
  Branch office ID filter (comma-separated)

- **operatingSystem** *(string, optional)*  
  Operating system name filter

- **ESUActivationStatus** *(string, optional)*  
  `na`: Not Applicable  
  `active`: Activated  
  `notActive`: Not Activated

## Sample Request

### Curl

```bash
curl --request GET \
  --url https://appdomain/dcapi/patch/reports/WinLegacyEoLSystemsView \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

### Java

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomain/dcapi/patch/reports/WinLegacyEoLSystemsView"))
        .header("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse<string> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("appdomain")

headers = { 'Authorization': "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52" }

conn.request("GET", "/dcapi/patch/reports/WinLegacyEoLSystemsView", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
```

### Deluge

```javascript
headersMap = Map();
headersMap.put("Accept", "application/json");

response = invokeUrl
[
    url: "https://appDomain/dcapi/patch/reports/WinLegacyEoLSystemsView"
    type: GET
    headers: headersMap
    connection: connection_name
]

info response;
```

### PowerShell

```powershell
$headers=@{}
$headers.Add("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/patch/reports/WinLegacyEoLSystemsView' -Method GET -Headers $headers
```

## Response Parameters

### HTTP 200

**Response Body:** `application/json`

#### JSON Object

- **Links** *(JSON object)*  
  Pagination links for next and previous pages  
  - **next** *(string)*  
    URL for the next page of results, or null if on the last page  
  - **prev** *(string)*  
    URL for the previous page of results, or null if on the first page  

- **messageResponse** *(JSON array)*  
  Array of legacy Windows EoL system entries  
  - **ComputerName** *(string)*  
    Name of the computer  
  - **DeviceFriendlyName** *(string)*  
    Friendly display name of the device  
  - **Domain** *(string)*  
    Domain name of the computer  
  - **EsuActivationStatus** *(string)*  
    ESU activation status: Activated, Not Activated, Not Applicable  
  - **IpAddress** *(string)*  
    IP address of the system  
  - **LoggedOnUsers** *(string)*  
    Currently logged on users  
  - **OperatingSystem** *(string)*  
    Full operating system name  
  - **Owner** *(string)*  
    Owner of the system, or `--`  
  - **RemoteOffice** *(string)*  
    Remote office name  
  - **ServicePack** *(string)*  
    Service pack or OS version  

- **metadata** *(JSON object)*  
  Pagination metadata  
  - **limit** *(string)*  
    Number of records per page  
  - **page** *(string)*  
    Current page number  

- **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

```json
{
  "metadata": {
    "limit": 25,
    "page": 1
  },
  "totalRecords": 2,
  "messageResponse": [
    {
      "LoggedOnUsers": "Administrator",
      "OperatingSystem": "Windows XP Professional",
      "EsuActivationStatus": "Not Applicable",
      "Owner": "--",
      "DeviceFriendlyName": "WinMachine10",
      "ComputerName": "WinMachine10",
      "ServicePack": "Windows XP x64 Edition Service Pack 2",
      "IpAddress": "3.59.54.70",
      "Domain": "linuxosgroup",
      "RemoteOffice": "localOfficeOne"
    },
    {
      "LoggedOnUsers": "Browser Security Manager",
      "OperatingSystem": "Windows 7 Professional Edition (x64)",
      "EsuActivationStatus": "Not Applicable",
      "Owner": "--",
      "DeviceFriendlyName": "WinMachine4",
      "ComputerName": "WinMachine4",
      "ServicePack": "Windows 7 SP1 (x64)",
      "IpAddress": "252.148.93.191",
      "Domain": "ZOHOCORP",
      "RemoteOffice": "Default Remote Office"
    }
  ],
  "totalPages": 1,
  "Links": {
    "next": null,
    "prev": null
  },
  "status": "success"
}
```

### HTTP 500

**Response Body:** `application/json`

- **error_code** *(string)*  
  Error code: INTERNAL_ERROR for server-side failures  

- **error_description** *(string)*  
  Localized error description: dc.rest.api_internal_error  

### Sample Response: HTTP 500

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

## Possible HTTP Status Codes

- **200** — Success  
- **500** — Internal Server 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