---
title: "listInstalledApps"
method: GET
path: "/v1/app"
---

# listInstalledApps

`GET /v1/app`

Retrieve a list of installed apps for the organization.

## Query parameters

- `component_type` 'CUSTOM_JOURNEY_BLOCK' | 'PORTAL_EXTENSION' — Type of app component
- `enabled` boolean
- `page` integer
- `pageSize` integer

## Response `200`

Successful response

- object
  - `apps` App[]
    - `app_id` string
    - `name` TranslatedString
      - `en` string — English translation
      - `de` string — German translation
    - `icon_url` string — URL of the app icon.
    - `documentation_url` string — URL of the app documentation.
    - `description` TranslatedString
      - `en` string — English translation
      - `de` string — German translation
    - `created_by` string
    - `created_at` string
    - `updated_at` string
    - `updated_by` string
    - `version` string
    - `author` Author
      - `name` string — Name of the author
      - `company` string, required — Company of the author
      - `email` string — Email of the author
    - `status` 'published' | 'pending'
    - `components` BaseComponent[]
      - union
        - object
          - `id` string, required — Unique identifier for the component
          - `name` TranslatedString
            - `en` string — English translation
            - `de` string — German translation
          - `options` Options[] — List of options for the app component
            - `key` string, required — Unique identifier for this configuration option
            - `label` string — Human-readable label for the configuration option
            - `required` boolean — Flag to indicate if this option is required
            - `description` string — Detailed description of what this configuration option does
            - `value` string — The configured value for this option. Is only present when the component is installed.
            - `type` 'text' | 'number' | 'boolean' | 'secret', required
          - `component_type` 'CUSTOM_JOURNEY_BLOCK', required
          - `configuration` JourneyBlockConfig, required
            - `component_url` string, required — URL of the web component object
            - `component_tag` string, required — Custom element tag for the component
        - object
          - `id` string, required — Unique identifier for the component
          - `name` TranslatedString
            - `en` string — English translation
            - `de` string — German translation
          - `options` Options[] — List of options for the app component
            - `key` string, required — Unique identifier for this configuration option
            - `label` string — Human-readable label for the configuration option
            - `required` boolean — Flag to indicate if this option is required
            - `description` string — Detailed description of what this configuration option does
            - `value` string — The configured value for this option. Is only present when the component is installed.
            - `type` 'text' | 'number' | 'boolean' | 'secret', required
          - `component_type` 'PORTAL_EXTENSION', required
          - `origin` 'END_CUSTOMER_PORTAL' | 'INSTALLER_PORTAL'
          - `configuration` PortalExtensionConfig, required
            - `id` string
            - `hooks` object[]
              - …
            - `links` object[]
              - …
    - `internal` boolean — Flag to indicate if the app is built by epilot.
    - `owner_org_id` string — Organization ID of the app owner, required for private apps
    - `access_level` 'public' | 'private' — Access level of the app.
  - `pagination` object
    - `total` integer
    - `page` integer
    - `pageSize` integer

## Changes

- **2025-01-29** `8b8dde19dac7` — 3 warning, 7 info
  - deleted the `query` request parameter `componentType`
  - removed the optional property `apps/items/app_id` from the response with the `200` status
  - removed the optional property `apps/items/config_options` from the response with the `200` status
  - added the new optional `query` request parameter `component_type`
  - …6 more

[Change history](https://skmtc.dev/epilot/apis/app-api/changes/v1/app/get.md)

---

[API](https://skmtc.dev/epilot/apis/app-api.md) · [All operations](https://skmtc.dev/epilot/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epilot/app-api/revisions/8b8dde19dac7/schema)