---
title: "listConfigurations"
method: GET
path: "/v1/app-configurations"
tags: ["App Configuration"]
---

# listConfigurations

`GET /v1/app-configurations`

List all app configuration metadata owned by an organization. To get full app configuration details, use the /v1/app-configurations/{appId} endpoint.

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

List of app configurations

- object
  - `configurations` ConfigurationMetadata[]
    - `app_id` string, required
    - `name` string, required — Name of the app
    - `author` Author
      - `name` string — Name of the author
      - `company` string, required — Company of the author
      - `email` string — Email of the author
    - `dev_mode` boolean — Flag to indicate if the app is in dev mode. If true, the app takes the override_url property of components into account.
    - `versions` string[], required — List of available versions of the app
    - `public_versions` string[] — List of available public versions of the app
    - `support_email` string — Email address for support requests
    - `latest_version` string, required — Latest version of the app
    - `category` string — Category of the app.
    - `icon_url` string — URL of the app icon.
    - `documentation_url` string — URL of the app documentation.
    - `description` object, required — Markdown description of the app.
      - `en` string, nullable — English translation
      - `de` string, required — German translation
    - `notifications` object — Configuration for developer notifications
      - `email` string, email — Email address to receive notifications
      - `events` NotificationEvent[] — List of events to subscribe to
    - `owner_org_id` string, required — Organization ID of the app owner, required for private apps or sandbox accounts
    - `internal` boolean — Flag to indicate if the app is built by epilot.
    - `pricing` object — Pricing information for the app
      - `pricing_type` 'FREE' | 'SUBSCRIPTION' | 'USAGE_BASED' | 'ONE_TIME' | 'CUSTOM' | 'UNKNOWN'
      - `billing_frequency` 'MONTHLY' | 'QUARTERLY' | 'YEARLY' | 'CUSTOM' — How often the subscription is billed
    - `configuration_audit` object — Audit information for the app
      - `created_at` string — Timestamp of the creation
      - `created_by` string — User ID of the creator
      - `updated_at` string — Timestamp of the last update
      - `updated_by` string — User ID of the last updater
  - `pagination` object
    - `total` integer
    - `page` integer
    - `pageSize` integer

---

[API](https://skmtc.net/epilot/apis/app-api.md) · [All operations](https://skmtc.net/epilot/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/app-api/versions/03b93188c6d4/schema)