---
title: "List apps"
method: GET
path: "/apps"
tags: ["Apps"]
---

# List apps

`GET /apps`

Returns a paginated list of apps on the Whop platform, with optional filtering by company, type, view support, and search query.

## Query parameters

- `app_type` 'b2b_app' | 'b2c_app' | 'company_app' | 'component' — The type of end-user an app is built for
- `company_id` string, nullable — Filter apps to only those created by this company, starting with 'biz_'.
- `direction` 'asc' | 'desc' — The direction of the sort.
- `order` 'created_at' | 'discoverable_at' | 'total_installs_last_30_days' | 'total_installs_last_7_days' | 'time_spent' | 'time_spent_last_24_hours' | 'daily_active_users' | 'ai_prompt_count' | 'total_ai_cost_usd' | 'total_ai_tokens' | 'last_ai_prompt_at' | 'ai_average_rating' — The order to fetch the apps in for discovery.
- `query` string, nullable — A search string to filter apps by name, such as 'chat' or 'analytics'.
- `verified_apps_only` boolean, nullable — Whether to only return apps that have been verified by Whop. Useful for populating a featured apps section.
- `view_type` 'hub' | 'discover' | 'dash' | 'dashboard' | 'analytics' | 'skills' | 'openapi' — The different types of an app view
- `after` string, nullable — Returns the elements in the list that come after the specified cursor.
- `before` string, nullable — Returns the elements in the list that come before the specified cursor.
- `first` integer, nullable — Returns the first _n_ elements from the list.
- `last` integer, nullable — Returns the last _n_ elements from the list.

## Response `200`

A successful response

- object — The connection type for PublicApp.
  - `data` AppListItem[], required — A list of nodes.
    - `app_type` 'b2b_app' | 'b2c_app' | 'company_app' | 'component', required — The type of end-user an app is built for
    - `base_url` string, nullable, required — The production base URL where the app is hosted. Null if no base URL is configured.
    - `company` object, required — The company that owns and publishes this app.
      - `id` string, required — The unique identifier for the company.
      - `title` string, required — The display name of the company shown to customers.
    - `creator` object, required — The user who created and owns the company that published this app.
      - `id` string, required — The unique identifier for the user.
      - `name` string, nullable, required — The user's display name shown on their public profile.
      - `username` string, required — The user's unique username shown on their public profile.
    - `dashboard_path` string, nullable, required — The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.
    - `description` string, nullable, required — A written description of what this app does, displayed on the app store listing page. Null if no description has been set.
    - `discover_path` string, nullable, required — The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.
    - `domain_id` string, required — The unique subdomain identifier for this app's proxied URL on the Whop platform. Forms the URL pattern https://{domain_id}.apps.whop.com.
    - `experience_path` string, nullable, required — The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.
    - `hosted_url` string, nullable, required — The full canonical URL where this app's hosted web build is served. Null if the app has not claimed a route.
    - `icon` object, nullable, required — The icon image for this app, displayed on the app store, product pages, checkout, and as the default icon for experiences using this app.
      - `url` string, nullable, required — A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.
    - `id` string, required — The unique identifier for the app.
    - `name` string, required — The display name of this app shown on the app store and in experience navigation. Maximum 30 characters.
    - `openapi_path` string, nullable, required — The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.
    - `origin` string, nullable, required — The full origin URL for this app's proxied domain (e.g., 'https://myapp.apps.whop.com'). Null if no proxy domain is configured.
    - `route` string, nullable, required — The unique subdomain route where this app's hosted web builds are served, such as 'myapp' for myapp.whop.app. Null if the app has not claimed a route.
    - `skills_path` string, nullable, required — The URL path template for a specific view of this app, appended to the base domain (e.g., '/experiences/[experienceId]'). Null if the specified view type is not configured.
    - `status` 'live' | 'unlisted' | 'hidden', required — The status of an experience interface
    - `verified` boolean, required — Whether this app has been verified by Whop. Verified apps are endorsed by Whop and displayed in the featured apps section of the app store.
  - `page_info` PageInfo, required — Information about pagination in a connection.
    - `end_cursor` string, nullable, required — When paginating forwards, the cursor to continue.
    - `has_next_page` boolean, required — When paginating forwards, are there more items?
    - `has_previous_page` boolean, required — When paginating backwards, are there more items?
    - `start_cursor` string, nullable, required — When paginating backwards, the cursor to continue.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/3a06a605784b/schema)