Whop

https://docs.whop.com/
Admin
Whop is a platform that empowers individuals and businesses to launch and scale internet businesses...
Tokens:4,462,712
Snippets:24,034
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Go example to retrieve setup intent

Source: https://docs.whop.com/api-reference/setup-intents/retrieve-setup-intent

Uses the net/http package to send a GET request with an Authorization header and prints the response body.

```Go
package main

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

func main() {

	url := "https://api.whop.com/api/v1/setup_intents/{id}"

	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))

}
```

--------------------------------

### Ruby example to retrieve setup intent

Source: https://docs.whop.com/api-reference/setup-intents/retrieve-setup-intent

Uses Net::HTTP to send a GET request with an Authorization header and prints the response body.

```Ruby
require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/setup_intents/{id}")

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
```

--------------------------------

### Python requests example to retrieve setup intent

Source: https://docs.whop.com/api-reference/setup-intents/retrieve-setup-intent

Uses the requests library to perform a GET request. The response is printed to stdout.

```Python
import requests

url = "https://api.whop.com/api/v1/setup_intents/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

--------------------------------

### List setup intents with cURL, Python, JavaScript, PHP, Go, Java, and Ruby

Source: https://docs.whop.com/api-reference/setup-intents/list-setup-intents

Send a GET request to the /api/v1/setup_intents endpoint to list setup intents. All examples use the same URL and require an Authorization header with a Bearer token. The response is a JSON object containing an array of setup intents.

```bash
curl --request GET \
  --url https://api.whop.com/api/v1/setup_intents \
  --header 'Authorization: Bearer <token>'
```

```python
import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/setup_intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/setup_intents",
  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;
}
```

```go
package main

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

func main() {

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

	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))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.whop.com/api/v1/setup_intents")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

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

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
```

--------------------------------

### List Setup Intents with cURL, Python, JavaScript, PHP, Go, Java, and Ruby

Source: https://docs.whop.com/api-reference/beta/setup-intents/list-setup-intents

Example requests for the List Setup Intents endpoint. Each example sends a GET request to https://api.whop.com/api/v1/setup_intents?first=20 with an Authorization header using a Bearer token. The endpoint lists setup intents newest first; an account API key lists its own account, while a user token lists every account it can read or one account with account_id. Note that client_secret is always null on list rows.

```bash
curl --request GET \
  --url 'https://api.whop.com/api/v1/setup_intents?first=20' \
  --header 'Authorization: Bearer <token>'
```

```python
import requests

url = "https://api.whop.com/api/v1/setup_intents?first=20"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/setup_intents?first=20', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/setup_intents?first=20",
  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;
}
```

```go
package main

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

func main() {

	url := "https://api.whop.com/api/v1/setup_intents?first=20"

	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))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.whop.com/api/v1/setup_intents?first=20")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/setup_intents?first=20")

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
```

--------------------------------

### PHP cURL example to retrieve setup intent

Source: https://docs.whop.com/api-reference/setup-intents/retrieve-setup-intent

Uses PHP's cURL extension to send a GET request with an Authorization header. Prints the response or a cURL error.

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/setup_intents/{id}",
  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;
}
```

--------------------------------

### Setup Intent

Source: https://docs.whop.com/llms-full.txt

Documentation for the Setup Intent resource, including its response fields and an example of creating one via the SDK.

```APIDOC
## Setup Intent

### Description
A setup intent allows a user to save a payment method for future use without making an immediate purchase. This resource has a successor in the Whop API, but this page stays fully supported.

### Method
N/A (Object representation)

### Endpoint
N/A

### Parameters
N/A

### Request Example
```typescript
const setupIntent = await client.setupIntents.create({
  account_id: "biz_xxxxxxxxxxxxx",
  confirmation_token: "ctok_xxxxxxxxxxxxxx",
  return_url: "https://yoursite.com/billing/saved",
  metadata: { customer_id: "your_internal_id" }
});
```

### Response
#### Success Response
- **checkout_configuration** (object | null) - The checkout session configuration associated with this setup intent. Null if no checkout session was used.
  - **id** (string) - The unique identifier for the checkout session. Example: `ch_xxxxxxxxxxxxxxx`
- **company** (object | null) - The company that initiated this setup intent. Null if the company has been deleted.
  - **id** (string) - The unique identifier for the company. Example: `biz_xxxxxxxxxxxxxx`
- **created_at** (string<date-time>) - The datetime the setup intent was created. Example: `2023-12-01T05:00:00.401Z`
- **error_message** (string | null) - A human-readable error message explaining why the setup intent failed. Null if no error occurred. Example: `Your card was declined.`
- **id** (string) - The unique identifier for the setup intent. Example: `sint_xxxxxxxxxxxxx`
- **member** (object | null) - The company member associated with this setup intent. Null if the user is not a member.
  - **id** (string) - The unique identifier for the company member.
  - **user** (object | null) - The user for this member, if any.
    - **email** (string | null) - The digital mailing address of the user.
    - **id** (string) - The unique identifier for the company member user.
    - **name** (string | null) - The user's full name.
    - **username** (string) - The whop username.
- **metadata** (object) - Additional metadata.
- **payment_method** (object) - The payment method saved.
  - **card** (object) - Card details.
    - **brand** (string) - Card brand (e.g., mastercard).
    - **exp_month** (integer) - Expiration month.
    - **exp_year** (integer) - Expiration year.
    - **last4** (string) - Last 4 digits.
  - **created_at** (string<date-time>) - Creation datetime.
  - **id** (string) - Payment method ID.
  - **mailing_address** (object) - Mailing address.
    - **city** (string) - City.
    - **country** (string) - Country.
    - **line1** (string) - Address line 1.
    - **line2** (string) - Address line 2.
    - **name** (string) - Name.
    - **postal_code** (string) - Postal code.
    - **state** (string) - State.
  - **payment_method_type** (string) - Type of payment method (e.g., acss_debit).
- **status** (string) - Status of the setup intent (e.g., processing).
- **three_ds_verified** (boolean) - Whether 3DS was verified.

#### Response Example
```json
{
  "checkout_configuration": {
    "id": "ch_xxxxxxxxxxxxxxx"
  },
  "company": {
    "id": "biz_xxxxxxxxxxxxxx"
  },
  "created_at": "2023-12-01T05:00:00.401Z",
  "error_message": "Your card was declined.",
  "id": "sint_xxxxxxxxxxxxx",
  "member": {
    "id": "<string>",
    "user": {
      "email": "<string>",
      "id": "<string>",
      "name": "<string>",
      "username": "<string>"
    }
  },
  "metadata": {},
  "payment_method": {
    "card": {
      "brand": "mastercard",
      "exp_month": 42,
      "exp_year": 42,
      "last4": "4242"
    },
    "created_at": "2023-12-01T05:00:00.401Z",
    "id": "payt_xxxxxxxxxxxxx",
    "mailing_address": {
      "city": "<string>",
      "country": "<string>",
      "line1": "<string>",
      "line2": "<string>",
      "name": "<string>",
      "postal_code": "<string>",
      "state": "<string>"
    },
    "payment_method_type": "acss_debit"
  },
  "status": "processing",
  "three_ds_verified": true
}
```
```

--------------------------------

### Retrieve Setup Intent with GET /setup_intents/{id}

Source: https://docs.whop.com/api-reference/beta/setup-intents/retrieve-setup-intent

Use these examples to retrieve a setup intent by its ID. Replace {id} with the setup intent ID and <token> with your API token. The response includes the setup intent details; once status is succeeded, payment_method_id is the saved method to charge or retrieve.

```bash
curl --request GET \
  --url https://api.whop.com/api/v1/setup_intents/{id} \
  --header 'Authorization: Bearer <token>'
```

```python
import requests

url = "https://api.whop.com/api/v1/setup_intents/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/setup_intents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/setup_intents/{id}",
  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;
}
```

```go
package main

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

func main() {

	url := "https://api.whop.com/api/v1/setup_intents/{id}"

	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))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.whop.com/api/v1/setup_intents/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/setup_intents/{id}")

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
```

--------------------------------

### Create setup intent with Go

Source: https://docs.whop.com/api-reference/setup-intents/create-setup-intent

Uses net/http to POST the setup intent payload as a JSON string. Prints the response body.

```go
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"confirmation_token\": \"ctok_xxxxxxxxxxxxxx\",\n  \"email\": \"buyer@example.com\",\n  \"metadata\": {},\n  \"return_url\": \"https://example.com/path\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

```

--------------------------------

### Run whop quickstart to select business

Source: https://docs.whop.com/llms-full.txt

Starts the CLI wizard to choose or create the Whop business the CLI acts on and signs you in. To sign in on its own, use `whop login --method oauth` which opens a browser.

```bash
whop quickstart
```

--------------------------------

### JavaScript fetch example to retrieve setup intent

Source: https://docs.whop.com/api-reference/setup-intents/retrieve-setup-intent

Uses the fetch API to make a GET request and logs the JSON response or error.

```JavaScript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/setup_intents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Select business with whop quickstart

Source: https://docs.whop.com/cli/overview

Picks the business the CLI acts on after signing in.

```bash
whop quickstart

```

--------------------------------

### Java Unirest example to retrieve setup intent

Source: https://docs.whop.com/api-reference/setup-intents/retrieve-setup-intent

Uses the Unirest HTTP library to send a GET request with an Authorization header and returns the response as a string.

```Java
HttpResponse<String> response = Unirest.get("https://api.whop.com/api/v1/setup_intents/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Create setup intent with Go

Source: https://docs.whop.com/api-reference/setup-intents/create-setup-intent

Uses the net/http package to POST the setup intent payload. Reads and prints the response body.

```go
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"confirmation_token\": \"ctok_xxxxxxxxxxxxxx\",\n  \"email\": \"buyer@example.com\",\n  \"metadata\": {},\n  \"return_url\": \"https://example.com/path\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Go example to list checkout configurations

Source: https://docs.whop.com/api-reference/checkout-configurations/list-checkout-configurations

Uses net/http to send a GET request with an Authorization header and prints the response body.

```go
package main

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

func main() {

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

	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))

}
```

--------------------------------

### Go request to list setup intents

Source: https://docs.whop.com/api-reference/setup-intents/list-setup-intents

Uses the net/http package to send a GET request to the setup_intents endpoint with an Authorization header.

```go
package main

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

func main() {

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

	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))

}
```

--------------------------------

### List checkout configurations - GET request examples

Source: https://docs.whop.com/api-reference/checkout-configurations/list-checkout-configurations

Send a GET request to the checkout configurations endpoint. All examples use the same URL and Authorization header with a bearer token placeholder.

```bash
curl --request GET \
  --url https://api.whop.com/api/v1/checkout_configurations \
  --header 'Authorization: Bearer <token>'
```

```python
import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/checkout_configurations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/checkout_configurations",
  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;
}
```

```go
package main

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

func main() {

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

	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))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.whop.com/api/v1/checkout_configurations")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

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

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
```

--------------------------------

### Go example to create an experience

Source: https://docs.whop.com/api-reference/experiences/create-experience

Uses net/http to send a POST request with a JSON string body. Prints the response body.

```go
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"app_id\": \"app_xxxxxxxxxxxxxx\",\n  \"is_public\": true,\n  \"logo\": {\n    \"id\": \"<string>\"\n  },\n  \"name\": \"<string>\",\n  \"notifications_enabled\": true,\n  \"section_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Response: Setup Status

Source: https://docs.whop.com/api-reference/beta/setup-intents/retrieve-setup-status

Example JSON response for a successful setup status retrieval.

```JSON
{
  "id": "sint_xxxxxxxxxxxxxx",
  "last_setup_error": {
    "code": "enrollment_declined",
    "message": "The bank declined the enrollment."
  },
  "next_action": {
    "data": {
      "frame_max_width": 500,
      "url": "https://psp.example/3ds/challenge"
    },
    "render": [
      "inline"
    ],
    "type": "redirect"
  },
  "object": "setup_status",
  "return_url": "https://shinetime.example/billing/saved",
  "status": "canceled"
}
```

--------------------------------

### GET /setup_intents

Source: https://docs.whop.com/api-reference/beta/setup-intents/setup-intent

Lists setup intents. Returns an array of setup intent objects.

```APIDOC
## GET /setup_intents

### Description
Lists setup intents.

### Method
GET

### Endpoint
`/setup_intents`

### Response
#### Success Response (200)
- **data** (array) - List of setup intent objects.

#### Response Example
```json
{
  "data": [
    {
      "id": "sint_...",
      "account_id": "biz_...",
      "checkout_configuration_id": "ch_...",
      "client_secret": null,
      "created_at": "2023-01-01T00:00:00Z",
      "last_setup_error": null,
      "member_id": "mber_...",
      "metadata": {},
      "payment_instrument": null
    }
  ]
}
```
```

--------------------------------

### Go example to attach experience

Source: https://docs.whop.com/api-reference/experiences/attach-experience

Uses net/http to POST the product_id to the attach endpoint. Reads and prints the response body.

```go
package main

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

func main() {

	url := "https://api.whop.com/api/v1/experiences/{id}/attach"

	payload := strings.NewReader("{\n  \"product_id\": \"prod_xxxxxxxxxxxxx\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Go example to create a lead

Source: https://docs.whop.com/api-reference/leads/create-lead

Uses net/http to POST the lead payload to /leads. Prints the response body.

```go
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"metadata\": {},\n  \"product_id\": \"prod_xxxxxxxxxxxxx\",\n  \"referrer\": \"<string>\",\n  \"user_id\": \"user_xxxxxxxxxxxxx\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### GET /setup_intents/{id}

Source: https://docs.whop.com/api-reference/beta/setup-intents/setup-intent

Retrieves a setup intent by its ID. Returns the setup intent object.

```APIDOC
## GET /setup_intents/{id}

### Description
Retrieves a setup intent by its ID.

### Method
GET

### Endpoint
`/setup_intents/{id}`

### Parameters
#### Path Parameters
- **id** (string) - Required - The setup intent ID, prefixed `sint_`.

### Response
#### Success Response (200)
- **setup_intent** (object) - The setup intent object.

#### Response Example
```json
{
  "id": "sint_...",
  "account_id": "biz_...",
  "checkout_configuration_id": "ch_...",
  "client_secret": "...",
  "created_at": "2023-01-01T00:00:00Z",
  "last_setup_error": null,
  "member_id": "mber_...",
  "metadata": {},
  "payment_instrument": null
}
```
```

--------------------------------

### List notification topics with GET request

Source: https://docs.whop.com/api-reference/beta/notifications/list-notification-topics

Send a GET request to the list notification topics endpoint with an Authorization header. The Go example uses the standard library, the Java example uses Unirest, and the Ruby example uses net/http. Replace <token> with a valid API key or token.

```go
package main

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

func main() {

	url := "https://api.whop.com/api/v1/notifications/topics?first=20"

	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))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.whop.com/api/v1/notifications/topics?first=20")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/notifications/topics?first=20")

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
```

--------------------------------

### GET /verifications

Source: https://docs.whop.com/api-reference/beta/verifications/list-verifications

This snippet documents the GET /verifications endpoint, including its parameters, request examples, and response structure.

```APIDOC
## GET /verifications

### Description
Retrieves a list of verifications for the authenticated account. This endpoint returns verification records including business and individual details, requested information, and required documents.

### Method
GET

### Endpoint
https://api.whop.com/api/v1/verifications

### Parameters
#### Query Parameters
- **order** (string) - Optional - Field to order results by. Example: `updated_at`.
- **direction** (string) - Optional - Sort direction. Example: `desc`.
- **account_id** (string) - Required - The account ID to filter verifications by.

### Request Example
```
curl --request GET \
  --url 'https://api.whop.com/api/v1/verifications?order=updated_at&direction=desc' \
  --header 'Authorization: Bearer <token>'
```

### Response
#### Success Response (200)
- **data** (array) - List of verification objects.
  - **id** (string) - Unique identifier for the verification.
  - **kind** (string) - Type of verification (e.g., `individual`).
  - **status** (string) - Current status (e.g., `action_required`).
  - **business_name** (string) - Business name if applicable.
  - **business_structure** (string) - Business structure (e.g., `sole_proprietorship`).
  - **country** (string) - Country code.
  - **created_at** (string) - Creation timestamp.
  - **updated_at** (string) - Last update timestamp.
  - **email** (string) - Email address.
  - **first_name** (string) - First name.
  - **last_name** (string) - Last name.
  - **phone** (string) - Phone number.
  - **date_of_birth** (string) - Date of birth.
  - **address** (object) - Address details (city, country, line1, line2, postal_code, state).
  - **requested_information** (array) - List of requested information items.
    - **id** (string) - Identifier for the requested information.
    - **label** (string) - Label describing the requirement.
    - **requirement** (string) - Requirement type (e.g., `bank_statement`).
    - **type** (string) - Type of information (e.g., `files`).
    - **action_url** (string) - URL for action.
    - **details_label** (string) - Label for details.
    - **details_required** (boolean) - Whether details are required.
    - **details_visible_for** (array) - List of roles that can see details.
    - **errors** (array) - List of errors associated with the item.
      - **code** (string) - Error code.
      - **reason** (string) - Error reason.
    - **optional** (boolean) - Whether the item is optional.
    - **options** (array) - Available options.
    - **response_type** (string) - Response type (e.g., `yes_no`).
    - **selection_mode** (string) - Selection mode (e.g., `single`).
    - **supporting_documents** (array) - List of supporting documents.
      - **content_type** (string) - MIME type.
      - **created_at** (string) - Creation timestamp.
      - **filename** (string) - File name.
      - **id** (string) - File identifier.
      - **object** (string) - Object type (e.g., `file`).
      - **size** (integer) - File size in bytes.
      - **upload_status** (string) - Upload status (e.g., `pending`).
      - **url** (string) - File URL.
      - **visibility** (string) - Visibility (e.g., `private`).
      - **multipart_chunk_size** (integer) - Chunk size for multipart upload.
      - **multipart_upload_id** (string) - Multipart upload ID.
      - **multipart_upload_urls** (array) - List of multipart upload URLs.
        - **part_number** (integer) - Part number.
        - **url** (string) - URL for the part.
      - **upload_headers** (object) - Upload headers.
      - **upload_url** (string) - Upload URL.
    - **supporting_files_explanation_allowed** (boolean) - Whether explanation is allowed.
    - **supporting_files_required** (boolean) - Whether supporting files are required.
    - **supporting_files_visible_for** (array) - List of roles that can see supporting files.
  - **required_documents** (array) - List of required documents.
    - **document** (string) - Document type (e.g., `id_card_front`).
    - **rejection_reason** (string) - Reason for rejection if any.
    - **status** (string) - Status (e.g., `submitted`).
  - **session_url** (string) - URL for the verification session.

#### Response Example
```
{
  "data": [
    {
      "address": {
        "city": "Austin",
        "country": "US",
        "line1": "4180 Burnet Rd",
        "line2": "Suite 2",
        "postal_code": "78756",
        "state": "TX"
      },
      "business_name": "Shine Time Auto Detailing, LLC",
      "business_structure": "sole_proprietorship",
      "country": "US",
      "created_at": "2026-06-01T12:00:00.000Z",
      "date_of_birth": "1990-01-01",
      "email": "marcus@shinetime.example",
      "first_name": "Marcus",
      "id": "idpf_xxxxxxxxxxxx",
      "kind": "individual",
      "last_name": "Webb",
      "phone": "+15551234567",
      "requested_information": [
        {
          "id": "inrqi_xxxxxxxxxxx",
          "label": "Bank Statement or a check for account ending in 4242",
          "requirement": "bank_statement",
          "type": "files",
          "action_url": "<string>",
          "details_label": "<string>",
          "details_required": true,
          "details_visible_for": [
            "<string>"
          ],
          "errors": [
            {
              "code": "document_not_readable",
              "reason": "The uploaded image was too blurry to read."
            }
          ],
          "optional": true,
          "options": [
            "sole_proprietorship"
          ],
          "response_type": "yes_no",
          "selection_mode": "single",
          "supporting_documents": [
            {
              "content_type": "application/pdf",
              "created_at": "2026-01-01T12:00:00.000Z",
              "filename": "evidence.pdf",
              "id": "file_xxxxxxxxxxxxxx",
              "object": "file",
              "size": 9670,
              "upload_status": "pending",
              "url": "https://whop-assets-example.s3.amazonaws.com/uploads/audio/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
              "visibility": "private",
              "multipart_chunk_size": 5242880,
              "multipart_upload_id": "upload-id",
              "multipart_upload_urls": [
                {
                  "part_number": 1,
                  "url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf"
                }
              ],
              "upload_headers": {},
              "upload_url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf"
            }
          ],
          "supporting_files_explanation_allowed": true,
          "supporting_files_required": true,
          "supporting_files_visible_for": [
            "<string>"
          ]
        }
      ],
      "required_documents": [
        {
          "document": "id_card_front",
          "rejection_reason": "Document image was too blurry to read.",
          "status": "submitted"
        }
      ],
      "session_url": "https://sumsub.com/session/abc",
      "status": "action_required",
      "updated_at": "2026-06-02T12:00:00.000Z"
    }
  ]
}
```

#### Error Responses
- **400 Bad Request** - Invalid request parameters.
  - **error** (object) - Error details.
    - **message** (string) - Error message.
    - **type** (string) - Error type (e.g., `bad_request`).
    - **code** (string) - Error code.
- **401 Unauthorized** - Authentication failed.
  - **error** (object) - Error details.
    - **message** (string) - Error message.
    - **type** (string) - Error type.
    - **code** (string) - Error code.
- **403 Forbidden** - Access denied.
  - **error** (object) - Error details.
    - **message** (string) - Error message.
    - **type** (string) - Error type.
    - **code** (string) - Error code.

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

--------------------------------

### GET /api/v1/transfers

Source: https://docs.whop.com/api-reference/beta/transfers/list-transfers

Documentation for the GET /api/v1/transfers endpoint, including query parameters, authorization, headers, and response examples.

```APIDOC
## [GET] /api/v1/transfers

### Description
Lists transfers. Use this endpoint to retrieve a paginated list of transfers, optionally filtered by origin or destination account, sorted and paginated with cursors.

### Method
GET

### Endpoint
/api/v1/transfers

### Parameters
#### Query Parameters
- **origin_id** (string) - Optional - Filter to transfers sent from this account. Provide this or destination_id.
- **destination_id** (string) - Optional - Filter to transfers received by this account. Provide this or origin_id.
- **order** (enum<string>) - Optional - Sort column. Defaults to created_at. Available options: `created_at`, `amount`
- **direction** (enum<string>) - Optional - Sort direction. Defaults to desc. Available options: `asc`, `desc`
- **created_before** (string) - Optional - Only transfers created strictly before this ISO 8601 timestamp.
- **created_after** (string) - Optional - Only transfers created strictly after this ISO 8601 timestamp.
- **first** (integer) - Optional - Number of results to return from the start of the range. Default: 20. Required range: `x <= 100`
- **after** (string) - Optional - Return results after this cursor. Use `page_info.end_cursor` from the previous response to fetch the next page.
- **last** (integer) - Optional - Number of results to return from the end of the range. Required range: `x <= 100`
- **before** (string) - Optional - Return results before this cursor. Use `page_info.start_cursor` from the previous response to fetch the previous page.

### Request Example
```
GET https://api.whop.com/api/v1/transfers?first=20
Authorization: Bearer <token>
```

### Response
#### Success Response (200)
- **data** (TransferListItem[] object[]) - required - List of transfer items.
- **page_info** (object) - required - Pagination information.

#### Response Example
```
{
  "data": [
    {
      "amount": 25,
      "created_at": "2026-01-01T12:00:00.000Z",
      "created_by_user": {
        "id": "user_xxxxxxxxxxxxxx",
        "username": "marcuswebb",
        "name": "Marcus Webb"
      },
      "currency": "usd",
      "destination_ledger_account_id": "ldgr_xxxxxxxxxxxxxx",
      "id": "ctt_xxxxxxxxxxxxxx",
      "object": "transfer",
      "origin_ledger_account_id": "ldgr_xxxxxxxxxxxxxx",
      "status": "succeeded",
      "failed_at": null,
      "failure_code": null,
      "failure_reason": null,
      "fee_amount": 0.5,
      "metadata": {
        "order_id": "SHINE-1042"
      },
      "notes": "Refund for the rescheduled interior detail"
    }
  ],
  "page_info": {
    "end_cursor": null,
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}
```

#### Error Response (400)
- **error** (object) - Error details.
  - **message** (string) - Error message.
  - **type** (string) - Error type.
  - **code** (string) - Error code.

#### Error Response Example
```
{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}
```
```

--------------------------------

### List Setup Intents with Go

Source: https://docs.whop.com/api-reference/beta/setup-intents/list-setup-intents

Use this Go program to fetch a list of setup intents from the Whop API. It makes a GET request with the Authorization header and prints the response body. Replace <token> with your API token.

```go
package main

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

func main() {

	url := "https://api.whop.com/api/v1/setup_intents?first=20"

	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))

}
```
Tokens:
Raw