Retrieve List of Downloaded Patches

Retrieves the list of all patches that have been downloaded to Endpoint Central.

Endpoints

get /dcapi/patch/reports/downloadedPatches

Copy full URL

Request URL

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

Scope

PatchMgmt.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Sample Request

Curl

Java

Python

Deluge

PowerShell

Copied!

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

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/downloadedPatches"))
        .header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

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

headers = { 'Authorization': " d92d4xxxxxxxxxxxxx15f52" }

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

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

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


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

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

    info response;

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

▼ Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON object

Hide Sub-Attributes

metadataJSON object

Pagination metadata

Show Sub-Attributes

limitstring

Number of records per page

pagestring

Current page number

totalRecordsstring

Total number of records matching the query

messageResponseJSON array

Array of downloaded patch entries

Show Sub-Attributes

JSON object

Show Sub-Attributes

patch_download_status_labelstring

Download status label key

patch_langstring

Patch language code

os_languagestring

OS language code

platform_name_transformstring

Transformed platform name

bulletin_idstring

Security bulletin identifier

patch_download_status_imagestring

Download status image path

patch_sizestring

Patch file size in bytes

download_time_transformstring

Formatted download time

patch_description_transformstring

Transformed patch description

status_idstring

Approval status ID, or null

download_statusstring

Download status code

patch_size_transformstring

Formatted patch file size

patch_statusstring

Patch status, or null

how_to_urlstring

How-to URL for the patch, or null

patch_idstring

Unique patch identifier

patch_namestring

Patch file name

patch_descriptionstring

Full description of the patch

i18n_transformstring

Transformed internationalization language name

patchdetails_patchidstring

Patch details patch ID

patch_name_transformstring

Transformed patch file name

superceded_bystring

Superceded by patch ID, or NA

i18nstring

Internationalization language key

status_labelstring

Approval status label key, or null

download_remarks_transformstring

Transformed download remarks

error_kb_urlstring

Error KB article URL, or null

patch_patchidstring

Patch patch ID reference

patch_location_idstring

Patch location ID

sizestring

Size value, or null

patch_released_time_transformstring

Formatted patch release date

superceded_by_transformstring

Transformed superceded by value

download_timestring

Download time in epoch milliseconds

pmpatchlocation_patchidstring

PM patch location patch ID

patch_languagestring

Patch language code

patch_updatedstring

Patch last updated time in epoch milliseconds

bulletin_id_transformstring

Transformed bulletin ID

download_remarks_argsstring

Download remarks arguments, or null

status_label_transformstring

Transformed approval status label

patch_supported_time_transformstring

Formatted patch supported date

platformstring

Platform code: 1=Windows, 2=Mac, 3=Linux

patch_released_timestring

Patch release time in epoch milliseconds

patch_id_transformstring

Transformed patch ID

platform_namestring

Platform display name

customerpatchstatus_patch_idstring

Customer patch status patch ID, or null

patch_typestring

Patch type code

patch_supported_timestring

Patch supported time in epoch milliseconds

patch_download_status_label_transformstring

Transformed download status label

download_remarksstring

Download remarks key

customer_idstring

Customer ID, or null

remarksstring

Additional remarks, or null

status_imagestring

Status image path, or null

totalPagesstring

Total number of pages available

LinksJSON object

Pagination links for next and previous pages

Show Sub-Attributes

nextstring

URL for the next page of results, or null if on the last page

prevstring

URL for the previous page of results, or null if on the first page

statusstring

Operation result: success

- HTTP code 500

Response Body - application/json

JSON object

Hide Sub-Attributes

error_codestring

Error code: INTERNAL_ERROR for server-side failures

error_descriptionstring

Localized error description: dc.rest.api_internal_error

Possible Response Codes

200HTTP code

500HTTP code

Sample Response: HTTP 200

Downloaded patches list

Copied!

  {
    "metadata": {
      "limit": 25,
      "page": 1
    },
    "totalRecords": "1",
    "messageResponse": [
      {
        "patch_download_status_label": "dc.common.SUCCESS",
        "patch_lang": "0",
        "os_language": "0",
        "platform_name_transform": "Windows",
        "bulletin_id": "TU-052",
        "patch_download_status_image": "images/download_success.png",
        "patch_size": "476432",
        "download_time_transform": "May 17, 2026 10:26 PM",
        "patch_description_transform": "HyperSnap 9 (9.6.1)",
        "status_id": null,
        "download_status": "221",
        "patch_size_transform": "14.04 MB",
        "patch_status": null,
        "how_to_url": null,
        "patch_id": "301087",
        "patch_name": "PreReqHandler.exe",
        "patch_description": "GIMP Prerequisite Handler",
        "i18n_transform": "Multilingual",
        "patchdetails_patchid": "301087",
        "patch_name_transform": "HS9Setup32DE.exe",
        "superceded_by": "NA",
        "i18n": "Multilingual",
        "status_label": null,
        "download_remarks_transform": "Already available in the server store",
        "error_kb_url": null,
        "patch_patchid": "301087",
        "patch_location_id": "1792660",
        "size": null,
        "patch_released_time_transform": "Dec 17, 2025",
        "superceded_by_transform": "NA",
        "download_time": "1779183057853",
        "pmpatchlocation_patchid": "301087",
        "patch_language": "0",
        "patch_updated": "1751356072000",
        "bulletin_id_transform": "TU-1292",
        "download_remarks_args": null,
        "status_label_transform": "Approved",
        "patch_supported_time_transform": "Dec 17, 2025",
        "platform": "1",
        "patch_released_time": "1385577000000",
        "patch_id_transform": "354364",
        "platform_name": "Windows",
        "customerpatchstatus_patch_id": null,
        "patch_type": "2",
        "patch_supported_time": "1397143425000",
        "patch_download_status_label_transform": "Success",
        "download_remarks": "desktopcentral.server.patchmgmt.patch_download_success",
        "customer_id": null,
        "remarks": null,
        "status_image": null
      }
    ],
    "totalPages": 1,
    "Links": {
      "next": null,
      "prev": null
    },
    "status": "success"
  }

▼ Show full

Sample Response: HTTP 500

Server-side error

Copied!

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

▼ Show full

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.