---
title: "Get a published app store app's full listing"
method: GET
path: "/apps/{appUuid}"
---

# Get a published app store app's full listing

`GET /apps/{appUuid}`

Returns the full listing for a single published app: description body, highlights, screenshots, pricing plans and rating distribution.

## Path parameters

- `appUuid` string, uuid, required

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

The app's full store listing

- object
  - `uuid` string, uuid, required
  - `name` string, required — User-facing app title.
  - `tagline` string, required
  - `description` string, required — Marketing description of the app.
  - `logoUrl` string, required
  - `appUrl` string, nullable, required
  - `pricingType` 'free' | 'monthly', required
  - `rating` object, required
    - `average` number, nullable, required — Weighted average rating (1-5), or null until the app has enough ratings to show.
    - `count` number, nullable, required — Number of genuine ratings, or null until the app has enough to show.
  - `developer` object, required
    - `name` string, nullable, required — The developer's public display name.
    - `handle` string, nullable, required — The developer's public Fanvue handle.
  - `descriptionTitle` string, required
  - `descriptionBody` string, required
  - `highlights` string[], required
  - `heroImageUrl` string, required
  - `previewImageUrls` string[], required
  - `galleryImageUrls` string[], required
  - `pricingPlans` object[], required
    - `uuid` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `billingType` 'free' | 'one_time' | 'recurring', required
    - `interval` 'monthly' | 'yearly', nullable, required
    - `price` number, required — Price in minor currency units (e.g. cents). 0 for free plans.
    - `currencyCode` string, required
    - `status` 'pending_setup' | 'active' | 'withdrawn', required
    - `highlights` string[], required — Marketing feature bullets for this plan's store card.
  - `ratingDistribution` object[], nullable, required
    - `rating` integer, required
    - `proportion` number, required — Share of genuine ratings at this star, 0..1.
    - `count` number, nullable, required — Genuine count at this star, or null below the floor.

## Other responses

- `400` — Bad Request - API version not supported OR validation failed OR invalid UUID
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — App not found or not published
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded
- `502` — Failed to load app listings from upstream
- `503` — App store upstream is not configured

---

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