# Retrieves the full details of a software package

Fetches complete package information including metadata, install/uninstall commands, uploaded files, and pre/post install scripts.

## Endpoints

`GET /dcapi/swDeployment/packageDetails`

## Request URL

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

## Scope

`DesktopCentralCloud.SWDeployment.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` **Mandatory**: `application/packageDetails.v1+json`

### Query Parameters

- **packageID** `long` **Mandatory**: Unique package identifier. Obtain from the `packageId` field in the response of the [List Packages](https://www.manageengine.com/products/desktop-central/help/api/cloud/packages-list-packages.html) API.

## Sample Request

```curl
curl --request GET \
  --url 'https://appdomains/dcapi/swDeployment/packageDetails?packageID=SOME_INTEGER_VALUE' \
  --header 'Accept: application/packageDetails.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

Response Body - `application/json`

- `JSON Object`
  - **packageId** `long`: Unique package identifier
  - **packageName** `string`: Display name of the package
  - **platform** `integer`: Platform ID: 1=Windows, 2=Mac, 3=Linux
  - **licenseType** `integer`: License type: 1=Commercial, 2=Non-Commercial
  - **description** `string`: User-provided description
  - **installCommand** `string`: Command used for installation
  - **uninstallCommand** `string`: Command used for uninstallation
  - **uploadedFile** `JSON Array`: Array of uploaded installer files
  - **preInstallCommand** `string`: Pre-installation script or command
  - **postInstallCommand** `string`: Post-installation script or command

### Sample Response: HTTP 200

Windows MSI package

```json
{
  "licenseType": 2,
  "installCommand": "msiexec /i 7z2301-x64.msi /qn",
  "preInstallCommand": "",
  "postInstallCommand": "",
  "packageId": 10001,
  "description": "7-Zip file archiver",
  "packageName": "7-Zip 23.01 x64",
  "uninstallCommand": "msiexec /x {ProductCode} /qn",
  "platform": 1,
  "uploadedFile": [
    {
      "fileName": "7z2301-x64.msi",
      "fileSize": 1884160,
      "fileId": 99001
    }
  ]
}
```

### HTTP code 500

Response Body - `application/json`

- `JSON Object`
  - **errorCode** `string`: INTERNAL_ERROR for DB query failures, SW_INTERNAL_ERROR for package operation errors
  - **errorMessage** `string`: Internal server error with details about the package retrieval or execution status failure

### Sample Response: HTTP 500

Server error

```json
{
  "errorMessage": "Internal Server Error",
  "errorCode": "INTERNAL_ERROR"
}
```

## Possible Response Codes

- **200** `HTTP code`
- **500** `HTTP code`

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