---
title: "Retrieve all environments for app"
method: GET
path: "/apps/{appId}/environments"
tags: ["apps"]
---

# Retrieve all environments for app

`GET /apps/{appId}/environments`

## Request

- Base URL: `https://pmp-demo.privateplatform.mendix.com/deployservice/v1`
- URL: `https://pmp-demo.privateplatform.mendix.com/deployservice/v1/apps/{appId}/environments`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Get all Standalone environments when platform in Standalone mode; Get all Connected environments when platform in Connected mode.

## Path parameters

- `appId` string, required

## Response `200`

Environment detail list

- Environment[]
  - `environmentId` string: Environment id
  - `internalName` string: Internal name of the environment
  - `displayName` string: Display name of the environment
  - `clusterName` string: Name of the cluster for the environment created
  - `namespace` string: Cluster namespace for the environment created
  - `storagePlanName` string: Name of the storage plan for the environment
  - `databasePlanName` string: Name of the database plan for the environment
  - `deploymentPurpose` 'Development' | 'Test' | 'Acceptance' | 'Production': Purpose of the deployment
  - `dtapMode` string: DTAP mode of the environment can be Development or Production
  - `appName` string: Name of the application
  - `appUrl` string: URL of the application
  - `clientIdForSecretStore` string: Client ID for access external secret store
  - `isExternalSecretStoreEnabled` string: Indicates if external secret store is enabled
  - `isAdminPasswordSecretStore` string: Indicates if admin password is stored as external secret
  - `status` 'Init' | 'Waiting' | 'Building' | 'Processing' | 'Success' | 'Ready' | 'Failed' | 'Unknown': Status of the environment
  - `readyReplicas` integer: Number of ready replicas for the environment
  - `replicas` integer: Total number of replicas for the environment
  - `isAppStopped` boolean: Indicates if the application is stopped
  - `isManualDeploy` boolean: Indicates if the deployment was manual
  - `leaderlessMode` string: Indicates if the environment was leaderless mode
  - `buildStatus` string: Status of the build process
  - `runtimeStatus` string: Status of the runtime environment
  - `networkStatus` string: Status of the network configuration
  - `databaseStatus` string: Status of the database connection
  - `storageStatus` string: Status of the storage configuration
  - `licenseStatus` string: Status of the license
  - `creationStatus` string: Status of the creation process
  - `resourceStatus` string: Status of the resources
  - `runtimeVersion` string: Version of the runtime environment
  - `lastStartTime` string: Timestamp of the last start time
  - `buildExplanation` string: Explanation for the build process
  - `storageExplanation` string: Explanation for the storage configuration
  - `runtimeExplanation` string: Explanation for the runtime environment
  - `Packages` object: App package deployed in the environment
    - `packageId` string: Package id
    - `packageName` string: Package name
    - `status` string: Package status
    - `locked` boolean: Indicates if the package is locked
    - `branch` string: The branch to which the package built from
    - `revision` string: The revision to which the package built from
    - `modelVersion` string: The model version of the package
    - `runtimeVersion` string: The runtime version required by the package
    - `createdBy` string: The user who created the package
    - `createdTime` string: The timestamp when the package was created
  - `Constants` object[]: Constants of the app deployed in the environment
    - `name` string
    - `currentValue` string
    - `newValue` string
    - `isSecretStore` string
    - `visibility` string
  - `ScheduledEvents` object[]: Scheduled events of the app deployed in the environment
    - `name` string
    - `currentEnabled` boolean
    - `newEnabled` boolean
  - `CustomEnvironmentVariables` object[]
    - `name` string: The name of the environment variable
    - `currentValue` string
    - `newValue` string: The value of the environment variable
  - `CustomRuntimeSettings` object[]
    - `name` string: The name of the runtime setting
    - `currentValue` string
    - `newValue` string: The value of the runtime setting
    - `isSecretStore` string
  - `CustomJVMOptions` object
    - `name` string: The name of the JVM option
    - `currentValue` string
    - `newValue` string: The value of the JVM option
  - `CustomJettyOptions` object
    - `name` string: The name of the Jetty option
    - `currentValue` string
    - `newValue` string: The value of the Jetty option
  - `Debugger` object
    - `enabled` 'Yes' | 'No': Indicates if the debugger is enabled
    - `password` string: The password for accessing the debugger
    - `url` string: The URL for accessing the debugger
    - `isSecretStore` 'Yes' | 'No': Indicates if the password is stored in external secret store
  - `LogLevels` object[]: Log levels of the environment
    - `node` string: The node for which the log level is set
    - `level` string: The log level for the specified node
  - `ClientCertificates` object[]: Client certificates of the environment network
    - `id` integer
    - `issuer` string
    - `subject` string
    - `validFrom` string
    - `validTo` string
    - `currentEnabled` boolean
    - `newEnabled` boolean
  - `CustomTLSConfig` object: TLS configuration of the environment network
    - `enableTLS` boolean: Whether to enable TLS for the environment
    - `tlsConfig` string: The TLS configuration for the environment
    - `useExistingSecret` string: The name of the existing secret for TLS configuration
  - `CoreResource` object: Core resource of the environment
    - `coreResourcePlan` string: The core resource plan for the environment
    - `coreResourceSize` 'Small' | 'Medium' | 'Large' | 'Custom': The size of the core resources for the environment
    - `cpuRequest` number: The CPU request for the environment
    - `cpuLimit` number: The CPU limit for the environment
    - `memRequest` number: The memory request for the environment
    - `memLimit` number: The memory limit for the environment
    - `ephemeralRequest` number: The ephemeral storage request for the environment
    - `ephemeralLimit` number: The ephemeral storage limit for the environment

## Other responses

- `400`: Invalid input parameter or request body
- `401`: Authentication information is missing or invalid
- `403`: User has no permission for this operation
- `404`: Resource not found

---

[API](https://skmtc.dev/mendix/apis/deploy-service-v1.md) - [All operations](https://skmtc.dev/mendix/apis/deploy-service-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/deploy-service-v1/revisions/375e6f7be385?raw)