---
title: "List installed Data Apps"
method: GET
path: "/v1/dataapps/apps"
tags: ["Data Apps"]
---

# List installed Data Apps

`GET /v1/dataapps/apps`

Retrieves a paginated list of Data Apps currently installed in your organization. Supports filtering by type, labels, and search term.

## Query parameters

- `limit` integer
- `page` integer
- `includeLabels` boolean
- `labelKey` string
- `labelValue` string
- `type` 'CONNECTED' | 'CONTAINER'
- `search` string
- `sort` 'name' | 'type'
- `sortDirection` 'asc' | 'desc'

## Response `200`

OK

- PaginatedDataApp
  - `dataApps` DataApp[]
    - `id` string, uuid
    - `name` string
    - `description` string
    - `url` string — If type is CONNECTED then the url to the external running application
    - `iconUrl` string
    - `type` string — The type of data app. Must be either "CONNECTED" or "CONTAINER"
    - `artifactType` 'CONTAINER' | 'TETRASPHERE' — Internal artifact type stored in the database
    - `deploymentType` 'SERVER' — Deployment model: SERVER (ECS container, iFrame)
    - `slug` string
    - `version` string
    - `otherVersions` string[]
    - `running` boolean — Whether the container data app is running
    - `namespace` string — The namespace of the data app
    - `platformRequirements` object[]
      - `type` 'ids' | 'tetraflow', required
      - `namespace` string, required
      - `slug` string, required
      - `version` string, required
    - `serviceRequirements` object[]
      - `type` 'ais', required
      - `minVersion` string, required
      - `maxVersion` string
    - `supportedPlatformVersion` object — The supported platform version range for this data app
      - `minVersion` string
      - `maxVersion` string
    - `artifactLabels` object[]
      - `name` string
      - `value` string
    - `labels` object[]
      - `name` string
      - `value` string
    - `providers` DataAppProvider[]
      - `id` string
      - `name` string
      - `orgSlug` string
      - `type` string
      - `iconUrl` string
      - `updatedAt` string, date-time
      - `createdAt` string, date-time
      - `updatedBy` string
      - `createdBy` string
      - `secrets` DataAppProviderSecret[]
        - `name` string
        - `value` string
        - `type` string
        - `required` boolean
        - `arn` string
        - `envName` string
  - `count` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `503` — Service Unavailable

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/versions/0205e2bace53/schema)