---
title: "List published app store apps"
method: GET
path: "/apps"
---

# List published app store apps

`GET /apps`

Returns the published App Store listings with their marketing metadata (title, tagline, description, pricing type, rating summary, logo and developer). Use `search` to filter and paginate for discovery.

## Query parameters

- `page` integer — Page number to retrieve (starts from 1)
- `size` integer — Number of items to return per page (1-50, default: 15)
- `search` string — Case-insensitive filter matched against the app's listing metadata.

## Headers

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

## Response `200`

Paginated list of published app store apps

- object
  - `data` object[], required — Array of app listings
    - `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.
  - `pagination` object, required — Pagination information
    - `page` number, required — Current page number
    - `size` number, required — Number of records returned in this response
    - `hasMore` boolean, required — Whether there are more items available on subsequent pages

## Other responses

- `400` — Bad Request - API version not supported OR validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `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)