Sign in
Apps

List Apps

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

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_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.

direction'asc' | 'desc'

Sort direction.

firstinteger

The number of apps to return (default 20, max 100).

afterstring

A cursor; returns apps after this position.

lastinteger

The number of apps to return from the end of the range.

beforestring

A cursor; returns apps before this position.

Response

apps listed

Example response

{
  "data": [
    {
      "account": {
        "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"
      },
      "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",
      "experience_path": "/experiences/[experienceId]",
      "hosted_url": "https://shine-time-booking.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",
      "skills_path": "/skills",
      "status": "unlisted"
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Changed in 8 of the 42 revisions of this API.7642

  • 86d0a97abfe52See the full diff
    • ○

      added the new optional query request parameter verified

      new-optional-request-parameter

    • ○

      query request parameter verified_apps_only was deprecated

      request-parameter-deprecated

    This revision also has 42 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • e91d507bda451See the full diff
    • ○

      added the new optional query request parameter recommended

      new-optional-request-parameter

  • 6a23760847c83See the full diff
    • ○

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

      request-parameter-enum-value-added

    • ○

      added the required property data/items/businesses_created_count to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/items/businesses_created_logo_urls to the response with the 200 status

      response-required-property-added

  • 48408451a1f01See the full diff
    • ○

      added the required property data/items/banner_image to the response with the 200 status

      response-required-property-added

  • a01100378e592See the full diff
    • ○

      added the required property data/items/account/logo_url to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/items/account/route to the response with the 200 status

      response-required-property-added

  • f1020c3ecda42See the full diff
    • ○

      added the optional property error/code to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property error/code to the response with the 401 status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • a602de67ab2511See the full diff
    • ●

      added the new website enum value to the data/items/app_type response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new enum value website to the query request parameter app_type

      request-parameter-enum-value-added

  • 60bbb4a6ffbc7530See the full diff
    • ▲

      the query request parameter app_type was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter direction was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter order was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter view_type was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      for the query request parameter direction, default value desc was added

      request-parameter-default-value-added

    • ▲

      for the query request parameter order, default value discoverable_at was added

      request-parameter-default-value-added

    • ▲

      removed the required property data/items/company from the response with the 200 status

      response-required-property-removed

    • ●

      deleted the query request parameter company_id

      request-parameter-removed

    • ●

      removed the optional property error/code from the response with the 400 status

      response-optional-property-removed

    • ●

      removed the optional property error/code from the response with the 401 status

      response-optional-property-removed

    • ●

      removed the optional property error/param from the response with the 400 status

      response-optional-property-removed

    • ●

      removed the optional property error/param from the response with the 401 status

      response-optional-property-removed

    • ○

      api operation id listApp removed and replaced with listApps

      api-operation-id-removed

    • ○

      added the new optional header request parameter Api-Version-Date to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter account_id

      new-optional-request-parameter

    • ○

      added the new enum value analytics to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

      added the new enum value asc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value b2b_app to the query request parameter app_type

      request-parameter-enum-value-added

    • ○

      added the new enum value b2c_app to the query request parameter app_type

      request-parameter-enum-value-added

    • ○

      added the new enum value company_app to the query request parameter app_type

      request-parameter-enum-value-added

    • ○

      added the new enum value component to the query request parameter app_type

      request-parameter-enum-value-added

    • ○

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

      request-parameter-enum-value-added

    • ○

      added the new enum value dash to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

      added the new enum value dashboard to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

      added the new enum value desc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value discover to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

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

      request-parameter-enum-value-added

    • ○

      added the new enum value hub to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

      added the new enum value openapi to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

      added the new enum value skills to the query request parameter view_type

      request-parameter-enum-value-added

    • ○

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

      request-parameter-enum-value-added

    • ○

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

      request-parameter-enum-value-added

    • ○

      for the query request parameter app_type, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • ○

      for the query request parameter direction, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • ○

      for the query request parameter order, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • ○

      for the query request parameter view_type, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • ○

      removed the non-success response with the status 403

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 404

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 422

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 429

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 500

      response-non-success-status-removed

    • ○

      added the required property data/items/account to the response with the 200 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog