---
title: "Retrieve deployment package"
method: GET
path: "/apps/{appId}/packages/{packageId}"
tags: ["packages"]
---

# Retrieve deployment package

`GET /apps/{appId}/packages/{packageId}`

## Request

- Base URL: `https://privatecloud.mendixcloud.com/api/v4`
- URL: `https://privatecloud.mendixcloud.com/api/v4/apps/{appId}/packages/{packageId}`
- Auth: API key in header `Authorization`

Retrieves the deployment package metadata. The query parameter can be used to request a time-limited download URL.

## Query parameters

- `url` boolean
- `log` boolean

## Response `200`

Deployment package metadata.

- Package: Model for deployment package.
  - `package` object
    - `id` string, uuid, required: Model for packageId.
    - `appId` string, uuid, required: The ID of a Mendix App. In the Developer Portal, this is shown as the App ID and it is a UUID format.
    - `modelVersion` string, required: The version of the model. This is set by the developer that created the package.
    - `runtimeVersion` string, required: The Mendix runtime version.
    - `createdOn` string, date-time, required: The date the package was created (uploaded or built).
    - `description` string
    - `fileName` string, required: The file name of the deployment package.
    - `fileSize` integer, required: The size of the deployment package file in bytes.
    - `buildLog` string: The build log for the deployment package. Can be used to debug potential issues encountered when creating the deployment package. Visibile only when the `log` query parameter is set to `true`.
    - `expiryDate` string, date-time: The date when the package is supposed to expire.
    - `url` object: Direct download URL of the deployment package file. This URL is valid for a limited time. Use the `url` query parameter set to `true` to retrieve an updated URL.
      - `location` string, uri, required: The URL of the deployment package file.
      - `ttl` integer, required: The validity of the URL in seconds.

## Other responses

- `401`: There were no usable authentication credentials found. The error response gives additional feedback.
- `403`: Access is denied. The provided credentials are incorrect or the credentials do not have the required level of access. The error response gives additional feedback.
- `404`: The requested item could not be found. The error response gives additional feedback.

---

[API](https://skmtc.dev/mendix/apis/private-cloud-build-api.md) - [All operations](https://skmtc.dev/mendix/apis/private-cloud-build-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/private-cloud-build-api/revisions/a16f9abda480?raw)
