# Retrieves the full details of a software package

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

## Endpoint

`GET /dcapi/swDeployment/packageDetails`

## Request URL

`https://{server-hostname}:8383/dcapi/swDeployment/packageDetails`

## Scope

`SWDeployment.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/swDeployment/packageDetails \
  --header 'Accept: application/packageDetails.v1+json' \
  --header 'Authorization:  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

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

## Possible Response Codes

- **200**: HTTP code
- **500**: HTTP code

## 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
    }
  ]
}
```

## Sample Response: HTTP 500

Server error

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

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