---
title: "Get list of apps"
method: GET
path: "/apps"
tags: ["apps"]
---

# Get list of apps

`GET /apps`

## Request

- Base URL: `https://cloud.home.mendix.com/api/v4`
- URL: `https://cloud.home.mendix.com/api/v4/apps`
- Auth: API key in header `Authorization`

Get an array of all applications for the authorized user. This API call does not return the same results as you can see within the Mendix Portal. It includes all licensed and free apps on the Mendix Cloud. Free apps include all apps which have been created or edited in Studio Pro, even if they have then been deployed to a different cloud such as Mendix for Private Cloud.

## Query parameters

- `offset` integer
- `limit` integer
- `licenseType` 'free' | 'licensed'

## Response `200`

OK

- Apps: An array of apps.
  - `apps` App[], required: The array of apps.
    - `id` string, uuid, required: The unique App ID of the app. This can be seen on the **General** page of the app in the Mendix Portal. It is a UUID format.
    - `name` string, required: The name of the app.
    - `licenseType` 'free' | 'licensed', required: The type of license. Free apps are created directly from Studio (Pro).
    - `subdomain` string, required: The environment URLs are based on this value. It is set when the app is created and cannot be changed. The value is unique in the Mendix Cloud.
    - `technicalContact` Membership, required: A Mendix user who is a team member of an app.
      - `userId` string, required: The ID of the user.
      - `name` string, required: The full name of the user.
      - `status` 'active' | 'inactive', required: The user's status in this membership. A user can have an active status in the Mendix platform but has an inactive status for an app.
    - `region` string, required: The region or cluster where the app's environments are running.
  - `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 array of objects. It starts at 0.
    - `limit` integer, required: The maximum number of objects to retrieve. When not specified then the server will set use the default value. If this is set to a number which is greater than the maximum supported number of objects, then the supported maximum is used.
    - `size` integer, required: The number of objects in the response.

## Other responses

- `400`: The request probably contains invalid data or there is data missing from the request. The error response gives additional feedback.
- `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.
- `500`: Internal system error.

---

[API](https://skmtc.dev/mendix/apis/deploy-api.md) - [All operations](https://skmtc.dev/mendix/apis/deploy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/deploy-api/revisions/4e82641fb4c5?raw)