Apps

List Apps

Changed on

Lists apps on the Whop platform: the app store's live apps, or — with account_id and developer access to that account — every app the account owns. Requires authentication except for Whop's public app and website discovery lists. Public website discovery includes built official blueprints (verified apps with a product) and built, live community blueprints that Whop recommends.

get/apps

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/apps
  • Auth: HTTP bearer

Query parameters

account_idstring

Only return apps created by this account (biz_ tag). With developer access to the account this includes its unlisted and hidden apps.

app_type'b2b_app' | 'b2c_app' | 'company_app' | 'component' | 'website'

Filter apps by the type of end-user they are built for. Apps of type website are left out unless you ask for them by name.

view_type'hub' | 'discover' | 'dash' | 'dashboard' | 'analytics' | 'skills' | 'openapi'

Only return apps supporting this view type, such as dashboard or hub.

verifiedboolean

Only return apps whose Whop verification status matches this value. Omit this filter to include every verification status the caller can see.

verified_apps_onlyboolean

Legacy compatibility filter. Use verified for field equality. true returns verified apps; clients pinned before 2026-08-25-2 retain the earlier public website discovery behavior.

recommendedboolean

Only return apps Whop recommends (or, with false, only those it does not), independently of verification status.

querystring

A search string matched against app names.

order'created_at' | 'discoverable_at' | 'template_recent_sales' | 'template_usage' | 'total_installs_last_30_days' | 'total_installs_last_7_days'

The field to sort apps by. Defaults to discoverable_at, showing the most recently published apps first. template_usage ranks Whop-verified apps first, then by how many businesses created apps from each app as a template. template_recent_sales ranks them by how many of those businesses processed a payment in the last 24 hours, recounted hourly, breaking ties by template_usage.

direction'asc' | 'desc'

Sort direction.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

apps listed

Example response

{
  "data": [
    {
      "account": {
        "fees": {
          "crypto_swap_markup": {
            "fixed_fee_usd": 0,
            "percentage_fee": 3
          },
          "transfer_markup": {
            "fixed_fee_usd": 0,
            "percentage_fee": 0
          }
        },
        "id": "biz_xxxxxxxxxxxxxx",
        "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "route": "shine-time-holdings",
        "title": "Shine Time Holdings"
      },
      "app_type": "b2c_app",
      "banner_image": {
        "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "base_url": "https://shine-time-booking-store.whop.site",
      "businesses_created_logo_urls": [
        "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ],
      "creator": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Marcus Webb",
        "username": "marcuswebb"
      },
      "dashboard_path": "/dashboard/[companyId]",
      "description": "Let members book a mobile detailing appointment without leaving your whop.",
      "discover_path": "/discover",
      "domain_id": "whopappdomain0000001",
      "domains": [
        {
          "domain": "from-template.whop.site",
          "id": "dom_xxxxxxxxxxxxxx",
          "status": "ready"
        }
      ],
      "experience_path": "/experiences/[experienceId]",
      "hosted_url": "https://shine-time-booking-store.whop.site",
      "icon": {
        "url": "https://pub-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.r2.dev/custom-perk-icon.svg"
      },
      "id": "app_xxxxxxxxxxxxxx",
      "name": "Shine Time Booking",
      "openapi_path": "/openapi.json",
      "origin": "https://whopappdomain0000001.apps.whop.com",
      "route": "shine-time-booking-store",
      "skills_path": "/skills",
      "status": "live",
      "verified": true
    }
  ],
  "page_info": {
    "end_cursor": "Mg",
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 7d2eaa643369Revision changes
    • breaking

      removed the required property // from the response with the status

    • info

      added the new enum value template_recent_sales to the query request parameter order

    • info

      response property data/items/hosted_url deprecated

    • info

      response property data/items/route deprecated

    • info

      added the required property // to the response with the status

  • de951faea120Revision changes
    • warning

      added the new idle enum value to the //// response property for the response status

    • warning

      added the new pending enum value to the //// response property for the response status

    • warning

      added the new ready enum value to the //// response property for the response status

    • warning

      added the new releasing enum value to the //// response property for the response status

    • info

      removed the active enum value from the //// response property for the response status

    • info

      removed the awaiting_payment enum value from the //// response property for the response status

    • info

      removed the deleting enum value from the //// response property for the response status

    • info

      removed the expired enum value from the //// response property for the response status

    • info

      removed the failed enum value from the //// response property for the response status

    • info

      removed the pending_verification enum value from the //// response property for the response status

    • info

      removed the provisioning enum value from the //// response property for the response status

    • info

      removed the registering enum value from the //// response property for the response status

    • info

      removed the removed enum value from the //// response property for the response status