---
title: "List marketplace apps"
method: GET
path: "/v1/apps"
tags: ["public", "apps"]
---

# List marketplace apps

`GET /v1/apps`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/apps`
- Auth: API key in header `Authorization`

Returns the CURRENT publication of each offering in the configured environment and architecture. There is no release, version, architecture or history parameter; such parameters are ignored.

## Query parameters

- `kind` 'plain_os' | 'control_panel' | 'application'
- `category` string
- `q` string
- `limit` integer
- `cursor` string
- `vcpu` integer
- `memory_mib` integer
- `disk_gib` integer

## Response `200`

OK

- MarketplacePublicOfferingList
  - `items` MarketplacePublicOfferingSummary[]
    - `availability` MarketplacePublicAvailability
      - `available` boolean
      - `reasons` MarketplaceReason[]
        - `code` string
        - `message` string
    - `category_ids` string[]
    - `contract_token` string
    - `display` MarketplacePublicOfferingDisplay
      - `guide` MarketplaceOfferingGuide
        - `about` string
        - `docs_url` string: DocsURL and SourceURL are the upstream project's own links, or empty.
        - `highlights` string[]: Highlights are short feature bullets.
        - `post_deploy` string[]: PostDeploy are the steps to take after the server is ready. The same steps are sent in the installed email.
        - `source_url` string
      - `name` string
      - `search_aliases` string[]
      - `summary` string
      - `version_label` string
    - `icon` MarketplacePublicOfferingIcon
      - `height` integer
      - `media_type` string
      - `url` string
      - `width` integer
    - `id` string
    - `kind` string
    - `lifecycle` string
    - `requirements` MarketplaceRequirements
      - `cluster_capabilities` string[]
      - `conflicting_ports` MarketplacePortRequirement[]
        - `port` integer
        - `protocol` string
      - `host_cpu_feature_class` string
      - `min_cpu` integer
      - `min_disk_gib` integer
      - `min_memory_mib` integer
      - `private_address_families` string[]
      - `public_address_families` string[]
      - `recommended_cpu` integer
      - `recommended_disk_gib` integer
      - `recommended_memory_mib` integer
      - `required_ports` MarketplacePortRequirement[]
        - `port` integer
        - `protocol` string
      - `static_public_ipv4` string
      - `storage_capabilities` string[]
  - `next_cursor` string

## Other responses

- `400`: Bad Request
- `401`: invalid or missing API key
- `403`: the key lacks catalog:read

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)