---
title: "Get a marketplace app"
method: GET
path: "/v1/apps/{id}"
tags: ["public", "apps"]
---

# Get a marketplace app

`GET /v1/apps/{id}`

## Request

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

Returns the CURRENT publication of one offering. A withdrawn offering is 404 — it never falls back to an older release.

## Path parameters

- `id` string, required

## Query parameters

- `vcpu` integer
- `memory_mib` integer
- `disk_gib` integer

## Response `200`

OK

- MarketplacePublicOfferingDetail
  - `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
  - `endpoints` MarketplacePublicContractEndpoint[]
    - `custom_domains` boolean
    - `kind` string
    - `name` string
    - `port` integer
  - `icon` MarketplacePublicOfferingIcon
    - `height` integer
    - `media_type` string
    - `url` string
    - `width` integer
  - `id` string
  - `input_schema` object
  - `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[]
  - `secret_outputs` MarketplacePublicContractSecretOutput[]
    - `classification` string
    - `name` string
    - `purpose` string
  - `ui_schema` object

## Other responses

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

---

[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)