---
title: "Get Manifests of Multiple Environments"
method: GET
path: "/apps/{appId}/environments"
tags: ["environments"]
---

# Get Manifests of Multiple Environments

`GET /apps/{appId}/environments`

## Request

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

Retrieves the manifests of all environments of an application.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

The environments manifests response returned by a get-environments-manifests request.

- object
  - `environments` GetEnvironmentManifest[]
    - `manifestVersion` string, required
    - `environment` object, required
      - `id` string, required: Model for environmentId.
      - `properties` object, required
        - `name` string, required
        - `production` boolean, required
        - `defaultStudioTarget` boolean, required
        - `secretsStoreEnabled` boolean, required
        - `OverwriteProductTypePCLM` string
        - `environmentPurpose` 'Test' | 'Development' | 'Acceptance' | 'Production': non-editable</br> Model for environmentPurpose.
      - `deployment` object, required
        - `appUrl` string, required
        - `packageId` string, required: PackageId of a Deployment Package. It can be found on the Deployment Package details page in the Portal.
        - `constants` Constant[]
          - `name` string
          - `value` string
        - `scheduledEvents` ScheduledEvent[]
          - `name` string
          - `enabled` boolean
        - `appLogLevels` AppLogLevel[]
          - `name` string
          - `level` 'CRITICAL' | 'NONE' | 'DEBUG' | 'TRACE' | 'INFO' | 'ERROR'
      - `container` object, required
        - `state` 'Ready' | 'Processing' | 'Failed' | 'Unknown'
        - `instances` integer, required
        - `lastRunningInstanceCount` integer: non-editable</br> If application is running, this is equal to the number of instances.</br> If the application is stopped, this is equal to the number of instances which the application was running before it stopped.
        - `coreResources` object, required
          - `limits` CoreResource, required: Model for resources (limits & requests).
            - `cpu` string, required: The unit of measurement is `Cores` and it will be added automatically.
            - `memory` string, required: The unit of measurement is `Gb` and it will be added automatically.
            - `ephemeralStorage` string: The unit of measurement is `Gb` and it will be added automatically.
          - `requests` CoreResource, required: Model for resources (limits & requests).
            - `cpu` string, required: The unit of measurement is `Cores` and it will be added automatically.
            - `memory` string, required: The unit of measurement is `Gb` and it will be added automatically.
            - `ephemeralStorage` string: The unit of measurement is `Gb` and it will be added automatically.
      - `network` object
        - `outgoingConnectionCertificate` object[]
          - `enabled` boolean
          - `password` string
          - `certificateType` string
          - `key` string
      - `runtime` object
        - `runtimeVersion` string
        - `environmentVariables` EnvironmentVariable[]
          - `name` string
          - `value` string
        - `customRuntimeSettings` CustomSetting[]
          - `name` string
          - `value` string
      - `provider` object, required
        - `clusterId` string, uuid, required
        - `namespace` string, required: Be aware that you cannot deploy environments to `Main` namespaces of Global Operator Installations.
        - `namespaceId` string, uuid: Model for namespaceId.
      - `annotations` Annotation[]
        - `key` string
        - `value` string
        - `annotationType` 'Pod' | 'Service' | 'Ingress'
      - `services` Service[], required
        - `name` string, required
        - `plan` 'OnDemand' | 'Dedicated', required
        - `config` '{type: \"database\"}' | '{type: \"storage\"}', required
      - `runtimeMetricsConfiguration` object
        - `mode` 'default' | 'native' | 'compatibility'
        - `interval` string
        - `mxAgentConfig` string
        - `mxAgentInstrumentationConfig` string
      - `deploymentStrategy` object
        - `runtimeDeploymentStrategyType` 'Reduced App Downtime' | 'Default': non-editable</br> PreferRolling updates gradually for continuous service(Reduced App Downtime); Recreate stops all Pods before restart(Default).
        - `switchOverthreshold` integer: Percentage point when Kubernetes updates all remaining old Pod.
        - `maxSurge` integer: Maximum percentage of extra Pods allowed above desired count during updates.
        - `maxUnavailable` integer: Maximum percentage of Pods that can be offline during updates.
        - `podDisruptionMinAvailable` integer: Pod Disruption Min Available defines the minimum number or percentage of Pods that must remain available during voluntary disruptions. This setting ensures a baseline level of running Pods is maintained; for example, if set to 50%, Kubernetes will only allow evictions that keep at least 50% of the Pods available.
        - `podDisruptionMaxUnavailable` integer: Pod Disruption Max Unavailable defines the maximum number or percentage of Pods that can be unavailable during voluntary disruptions (evictions or node drains). This setting controls how many existing Pods can be taken offline at once without affecting overall availability. For example, if set to 20%, Kubernetes can allow up to 20% of the Pods to be unavailable during voluntary disruptions.

## 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/mendix-for-private-cloud-deploy-api.md) - [All operations](https://skmtc.dev/mendix/apis/mendix-for-private-cloud-deploy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/mendix-for-private-cloud-deploy-api/revisions/ae247dcd18e1?raw)