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

# Retrieve list of deployment packages

`GET /apps/{appId}/packages`

## Request

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

Retrieve all deployment packages of a specific application.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

List of deployment packages.

- Packages: The model for the list of deployment packages.
  - `packages` object[], required
    - `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.
    - `expiryDate` string, date-time: The date when the package is supposed to expire.
  - `pagination` Pagination, required: Pagination attributes that reflect the parameters used to get the objects in the response.
    - `offset` integer, required: The offset used to get the list of objects. It starts at 0.
    - `limit` integer, required: The maximum amount of objects to retrieve. When not specified, the a default value is 20.
    - `size` integer, required: The amount of objects in the response.

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