List Apps

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const appListResponse of client.apps.list()) {
  console.log(appListResponse.id);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/apps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/apps"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/apps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
      },
      "base_url": "<string>",
      "businesses_created_count": 0,
      "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.app",
      "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",
      "verified": false
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

GET

apps

JavaScript

import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const appListResponse of client.apps.list()) {
  console.log(appListResponse.id);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/apps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/apps"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/apps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
      },
      "base_url": "<string>",
      "businesses_created_count": 0,
      "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.app",
      "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",
      "verified": false
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-08-21"

Query Parameters

account_id

string

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

app_type

enum<string>

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.

Available options:

b2b_app,

b2c_app,

company_app,

component,

website

view_type

enum<string>

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

Available options:

hub,

discover,

dash,

dashboard,

analytics,

skills,

openapi

verified_apps_only

boolean

Whether to only return apps verified by Whop. Verified website templates — websites with a published web build — are included, even though websites are otherwise left out of app lists.

query

string

A search string matched against app names.

order

enum<string>

default:discoverable_at

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 apps with a banner image, then by how many apps were created from each app as a template.

Available options:

created_at,

discoverable_at,

template_usage,

total_installs_last_30_days,

total_installs_last_7_days

direction

enum<string>

default:desc

Sort direction.

Available options:

asc,

desc

first

integer

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

after

string

A cursor; returns apps after this position.

last

integer

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

before

string

A cursor; returns apps before this position.

Response

apps listed

data

object[]

required

Show child attributes

page_info

object

required

Show child attributes

⌘I

Introduction

Reference

Webhooks & events

Core Resources

Notifications

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Authorizations

Headers

Query Parameters

Response