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": [
    {
      "app_type": "b2b_app",
      "company": {
        "id": "biz_xxxxxxxxxxxxxx",
        "title": "Pickaxe"
      },
      "creator": {
        "id": "user_xxxxxxxxxxxxx",
        "name": "John Doe",
        "username": "johndoe42"
      },
      "dashboard_path": "/experiences/[experienceId]",
      "description": "A comprehensive analytics dashboard for tracking revenue, members, and growth metrics.",
      "discover_path": "/experiences/[experienceId]",
      "domain_id": "ab1c2d3e4f5g6h7i8j9k",
      "experience_path": "/experiences/[experienceId]",
      "hosted_url": "https://myapp.whop.app",
      "icon": {
        "url": "https://media.whop.com/abc123/optimized.jpg"
      },
      "id": "app_xxxxxxxxxxxxxx",
      "name": "Courses",
      "openapi_path": "/experiences/[experienceId]",
      "origin": "<string>",
      "route": "myapp",
      "skills_path": "/experiences/[experienceId]",
      "status": "live",
      "verified": true
    }
  ],
  "page_info": {
    "end_cursor": "<string>",
    "has_next_page": true,
    "has_previous_page": true,
    "start_cursor": "<string>"
  }
}

{
  "error": {
    "code": "parameter_missing",
    "message": "Missing required parameter: amount.",
    "param": "amount",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Invalid or missing API key",
    "type": "unauthorized"
  }
}

{
  "error": {
    "message": "You do not have permission to access this resource",
    "type": "forbidden"
  }
}

{
  "error": {
    "message": "Resource not found",
    "type": "not_found"
  }
}

{
  "error": null
}

{
  "error": null
}

{
  "error": {
    "message": "An unexpected error occurred",
    "type": "internal_server_error"
  }
}

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": [
    {
      "app_type": "b2b_app",
      "company": {
        "id": "biz_xxxxxxxxxxxxxx",
        "title": "Pickaxe"
      },
      "creator": {
        "id": "user_xxxxxxxxxxxxx",
        "name": "John Doe",
        "username": "johndoe42"
      },
      "dashboard_path": "/experiences/[experienceId]",
      "description": "A comprehensive analytics dashboard for tracking revenue, members, and growth metrics.",
      "discover_path": "/experiences/[experienceId]",
      "domain_id": "ab1c2d3e4f5g6h7i8j9k",
      "experience_path": "/experiences/[experienceId]",
      "hosted_url": "https://myapp.whop.app",
      "icon": {
        "url": "https://media.whop.com/abc123/optimized.jpg"
      },
      "id": "app_xxxxxxxxxxxxxx",
      "name": "Courses",
      "openapi_path": "/experiences/[experienceId]",
      "origin": "<string>",
      "route": "myapp",
      "skills_path": "/experiences/[experienceId]",
      "status": "live",
      "verified": true
    }
  ],
  "page_info": {
    "end_cursor": "<string>",
    "has_next_page": true,
    "has_previous_page": true,
    "start_cursor": "<string>"
  }
}

{
  "error": {
    "code": "parameter_missing",
    "message": "Missing required parameter: amount.",
    "param": "amount",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Invalid or missing API key",
    "type": "unauthorized"
  }
}

{
  "error": {
    "message": "You do not have permission to access this resource",
    "type": "forbidden"
  }
}

{
  "error": {
    "message": "Resource not found",
    "type": "not_found"
  }
}

{
  "error": null
}

{
  "error": null
}

{
  "error": {
    "message": "An unexpected error occurred",
    "type": "internal_server_error"
  }
}

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

Query Parameters

app_type

enum<string>

Filter apps by the type of end-user they are built for, such as consumer or business.

Available options:

b2b_app,

b2c_app,

company_app,

component,

website

company_id

string

Filter apps to only those created by this company, starting with 'biz_'.

Example:

"biz_xxxxxxxxxxxxxx"

direction

enum<string>

The sort direction for results. Accepted values: asc, desc.

Available options:

asc,

desc

order

enum<string>

The field to sort apps by. Defaults to discoverable_at descending, showing the most recently published apps first.

Available options:

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

query

string

A search string to filter apps by name, such as 'chat' or 'analytics'.

verified_apps_only

boolean

Whether to only return apps that have been verified by Whop. Useful for populating a featured apps section.

view_type

enum<string>

Filter apps to only those supporting a specific view type, such as 'dashboard' or 'hub'.

Available options:

hub,

discover,

dash,

dashboard,

analytics,

skills,

openapi

after

string

Returns the elements in the list that come after the specified cursor.

before

string

Returns the elements in the list that come before the specified cursor.

first

integer

Returns the first n elements from the list.

Example:

42

last

integer

Returns the last n elements from the list.

Example:

42

Response

A successful response

The connection type for PublicApp.

data

object[]

required

A list of nodes.

Show child attributes

page_info

object

required

Information to aid in pagination.

Show child attributes

⌘I

Introduction

Ledger stats

Developer

Ads

CRM

AI

Identity

Bounties

Cards

Engagement

Payins

Courses

Payouts

Stats

Authorizations

Query Parameters

Response