---
title: "GET /api/apps/{urn}"
method: GET
path: "/api/apps/{urn}"
tags: ["Apps"]
---

# GET /api/apps/{urn}

`GET /api/apps/{urn}`

## Path parameters

- `urn` string, required

## Response `default`

- GetAppDto
  - `info` object, required
    - `author` string, required
    - `available` boolean, required
    - `categories` string[], required
    - `created_at` integer, required
    - `deprecated` boolean, required
    - `description` string, required
    - `dynamic_config` boolean, required
    - `exposable` boolean, required
    - `force_expose` boolean, required
    - `force_pull` boolean, required
    - `form_fields` object[], required
      - `env_variable` string, required
      - `label` string, required
      - `required` boolean, required
      - `type` 'boolean' | 'email' | 'fqdn' | 'fqdnip' | 'ip' | 'number' | 'password' | 'random' | 'text' | 'url', required
      - `default` union
        - number
        - string
        - boolean
      - `encoding` 'base64' | 'hex'
      - `hint` string
      - `max` number
      - `min` number
      - `options` object[]
        - `label` string, required
        - `value` string, required
      - `pattern_error` string
      - `placeholder` string
      - `regex` string
    - `generate_vapid_keys` boolean, required
    - `https` boolean, required
    - `id` string, required
    - `name` string, required
    - `no_gui` boolean, required
    - `short_desc` string, required
    - `source` string, required
    - `supported_architectures` string[], required
    - `tipi_version` number, required
    - `updated_at` integer, required
    - `urn` string, required
    - `version` string, required
    - `gid` number
    - `min_tipi_version` string
    - `port` number
    - `uid` number
    - `url_suffix` string
    - `website` string
  - `metadata` object, required
    - `latestVersion` number, required
    - `localSubdomain` string, required
    - `composeSchemaVersion` number
    - `hasCustomConfig` boolean
    - `latestDockerVersion` string
    - `minTipiVersion` string, nullable
  - `app` object, nullable
    - `createdAt` number, required
    - `domain` string, nullable, required
    - `exposed` boolean, required
    - `exposedLocal` boolean, required
    - `id` number, required
    - `ignoredVersion` number, nullable, required
    - `isVisibleOnGuestDashboard` boolean, required
    - `openPort` boolean, required
    - `pendingRestart` boolean, required
    - `port` number, nullable, required
    - `status` 'backing_up' | 'installing' | 'missing' | 'resetting' | 'restarting' | 'restoring' | 'running' | 'starting' | 'stopped' | 'stopping' | 'uninstalling' | 'updating', required
    - `templateUrn` string, nullable, required
    - `updatedAt` number, required
    - `version` number, required
    - `config` object
    - `enableAuth` boolean
    - `localSubdomain` string, nullable

---

[API](https://skmtc.net/runtipi/apis/runtipi-api.md) · [All operations](https://skmtc.net/runtipi/apis/runtipi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runtipi/runtipi-api/revisions/5c7deb969194/schema)