> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> What the API does, how requests work, and a map of every resource.

The Current API is how you move money programmatically. Accept payments with checkout links, hold balances, send payouts, issue cards, transfer funds between accounts, and manage the products and variants you sell. Do it all from your server with one API key.

## Make a request

The base URL is `https://api.whop.com/api/v1`. Authenticate every request with a Bearer API key:

```bash theme={null}
curl https://api.whop.com/api/v1/accounts/me \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

```json theme={null}
{
	"id": "biz_XXXXXXXX",
	"title": "Acme Studio",
	"route": "acme-studio",
	"status": "approved"
}
```

If you're new, the [Quickstart](/api-reference/beta/quickstart) takes you from [creating a key](https://whop.com/dashboard/developer) to a live checkout link in about five minutes.

## How requests work

### Authentication

[Create an API key here](https://whop.com/dashboard/developer) under **Account API Keys**. Keys belong to an account and carry the permissions you grant them. Keep keys on your server, never in browser code, mobile apps, or public repos.

### Versioning

Whop versions the API by date. Send an `Api-Version-Date` header, such as `2026-07-01`, to pin the shapes of your requests and responses. Later changes won't break a pinned caller. When you omit the header, requests use the original `2025-01-01` shapes. Generated SDKs always send the latest version available when Whop built them. See [Versioning](/developer/api/versioning).

### Pagination

List endpoints return a `data` array plus a `page_info` object. Pass `first` to choose the page size. Pass `after` with the previous response's `page_info.end_cursor` to fetch the next page. `page_info.has_next_page` tells you when to stop.

### Errors

Failed requests return a conventional HTTP status (`400`, `401`, `403`, `404`) and a body with a single `error` object: `type` is a machine-readable code and `message` explains what went wrong.

```json theme={null}
{
	"error": {
		"type": "invalid_parameters",
		"message": "initial_price must be greater than 0"
	}
}
```

## Where everything lives

This reference covers the Current API. These resources are documented in the [Legacy API reference](/api-reference/payments/payment):

* Charging: [Payments](/api-reference/payments/payment), [Refunds](/api-reference/refunds/refund), [Invoices](/api-reference/invoices/invoice), [Payment methods](/api-reference/payment-methods/payment-method)
* Content and community: [Courses](/api-reference/courses/course), [Forums](/api-reference/forums/forum), [Messages](/api-reference/messages/message)
* Growth: [Affiliates](/api-reference/affiliates/affiliate), [Leads](/api-reference/leads/lead), [Reviews](/api-reference/reviews/review)

Use the API selector at the top of the sidebar to switch between references.

## Resources

### Core Resources

The accounts and people everything else hangs off.

| Resource | What it's for |
| - | - |
| [Accounts](/api-reference/beta/accounts/account) | A business on Whop: profile, wallet, capabilities, settings. |
| [Users](/api-reference/beta/users/user) | A person on Whop: profile and connected identities. |
| [Members](/api-reference/beta/members/member) | One buyer's relationship with an account, across all their purchases. |
| [Team Members](/api-reference/beta/team-members/team-member) | An account's team members and the roles that scope their access. |
| [External Accounts](/api-reference/beta/external-accounts/external-account) | Profiles on other platforms connected to an account or user. |
| [Social Accounts](/api-reference/beta/social-accounts/social-account) | Deprecated compatibility endpoints for external accounts. |

### Payments

Accept payments from buyers and handle what comes after.

| Resource | What it's for |
| - | - |
| [Payments](/api-reference/beta/payments/payment) | A charge against a buyer, and the step they still owe. |
| [Confirmation Tokens](/api-reference/beta/confirmation-tokens/confirmation-token) | A short-lived reference to payment details collected from a buyer. |
| [Payment Quotes](/api-reference/beta/payment-quotes/payment-quote) | A purchase priced before it is paid: its lines, promo code and tax. |
| [Setup Intents](/api-reference/beta/setup-intents/setup-intent) | Saving a buyer's payment method without charging it. |
| [Refunds](/api-reference/beta/refunds/refund) | Money returned to a buyer from a payment. |
| [Resolution Center Cases](/api-reference/beta/resolution-center-cases/resolution-center-case) | File or respond to a case against a payment, as the buyer or the merchant. |
| [Dispute Alerts](/api-reference/beta/dispute-alerts/dispute-alert) | Issuer warnings that arrive before a chargeback does. |
| [Disputes](/api-reference/beta/disputes/dispute) | Chargebacks filed against an account, with evidence and outcomes. |
| [Payment Rules](/api-reference/beta/payment-rules/payment-rule) | Rules an account writes to decide its own payments. |

### Money

Balances and banking: every way funds move in or out.

| Resource | What it's for |
| - | - |
| [Deposits](/api-reference/beta/deposits/deposit) | Add funds to a balance. |
| [Transfers](/api-reference/beta/transfers/transfer) | Move funds between Whop accounts and users. |
| [Payouts](/api-reference/beta/payouts/payout) | Send money from a balance to a bank or wallet. |
| [Financial Activity](/api-reference/beta/ledgers/ledger-activity) | The activity feed behind an account or user's balance. |
| [Cards](/api-reference/beta/cards/card) | Issue cards that spend from a balance. |
| [Cashback Rules](/api-reference/beta/cashback-rules/cashback-rule) | Configure platform-sponsored card cashback. |
| [Swaps](/api-reference/beta/swaps/swap) | Convert a balance between currencies. |
| [Trades](/api-reference/beta/trades/trade) | Place orders, close positions, and move funds for perpetual and spot trading from a Whop-managed wallet. |
| [Verifications](/api-reference/beta/verifications/verification) | Legal identity required before payouts and card issuing. |

### Commerce

Sell products and get paid.

| Resource | What it's for |
| - | - |
| [Products](/api-reference/beta/products/product) | The things you sell. Each owns variants and a store page. |
| [Variants](/api-reference/beta/variants/variant) | Purchasable configurations of a product. |
| [Promo Codes](/api-reference/beta/promo-codes/promo-code) | Discounts that creators configure for checkout. |
| [Checkout Configurations](/api-reference/beta/checkout-configurations/checkout-configuration) | Turn a variant into a shareable, prefilled checkout link. |
| [Waitlist Entries](/api-reference/beta/waitlist-entries/waitlist-entry) | Join waitlists and manage customer signups awaiting approval. |
| [Memberships](/api-reference/beta/memberships/membership) | A customer's purchase of a variant, from checkout through cancellation. |
| [Shipments](/api-reference/beta/shipments/shipment) | Track the delivery of an order by its carrier tracking number. |
| [Reviews](/api-reference/beta/reviews/list-reviews) | Customer star ratings and written feedback on a product. |
| [Product Affiliates](/api-reference/beta/product-affiliates/product-affiliate) | Users enrolled to promote a product, including affiliates with no referrals. |

### Websites

Hosted apps, their builds and domains, and the experiments that run on them.

| Resource | What it's for |
| - | - |
| [Domains](/api-reference/beta/domains/domain) | Custom domains assigned to hosted apps. |
| [Apps](/api-reference/beta/apps/app) | Apps you build on Whop: metadata, hosted builds, runtime logs. |
| [App Builds](/api-reference/beta/app-builds/app-build) | Versioned build artifacts deployed to an app's platforms. |
| [Experiments](/api-reference/beta/experiments/experiment) | Feature flags and A/B experiments for gradual rollout. |

### Ads

Run and measure ad campaigns from your integration.

| Resource | What it's for |
| - | - |
| [Ad Campaigns](/api-reference/beta/ad-campaigns/ad-campaign) | Platform, objective, and budget for a set of ads. |
| [Ad Groups](/api-reference/beta/ad-groups/ad-group) | Audience, placements, and schedule within a campaign. |
| [Ads](/api-reference/beta/ads/ad) | The creative: copy, assets, and destination URL. |
| [Audiences](/api-reference/beta/audiences/audience) | Reusable targeting lists for ad groups. |
| [Ad Pixels](/api-reference/beta/ad-pixels/ad-pixel) | Your own pixels that receive conversions from campaigns you claimed. |
| [Ad Conversion Value Rules](/api-reference/beta/ad-conversion-value-rules/ad-conversion-value-rule) | Modify how conversion events are delivered to ad networks. |

### Analytics

Who visits, what converts, and how an account is performing.

| Resource | What it's for |
| - | - |
| [Stats](/api-reference/beta/stats/stats) | Aggregated financial, audience, and traffic reporting. |
| [People](/api-reference/beta/people/person) | Visitors and customers of an account, with identity, purchase, and traffic profiles. |
| [Events](/api-reference/beta/events/event) | Conversion and engagement events tracked for attribution. |
| [Exports](/api-reference/beta/exports/export) | Asynchronous CSV dumps of an account's dashboard data. |
| [Economic Intelligence](/api-reference/beta/economic-intelligence/economic-intelligence) | What an account should do next to grow, generated from its own data. |

### Partners

Refer users and businesses to Whop and track what you earn.

| Resource | What it's for |
| - | - |
| [Partners](/api-reference/beta/partners/partner) | Your partner profile, referral links, payout rates, and referred businesses. |
| [Partner Referral Requests](/api-reference/beta/partner-referral-requests/partner-referral-request) | Request business or partner attribution and manage approval. |

### Workforce

Post paid tasks and pay people for completed work.

| Resource | What it's for |
| - | - |
| [Bounties](/api-reference/beta/bounties/bounty) | Paid tasks with reviewed submissions and escrowed rewards. |
| [Bounty Submissions](/api-reference/beta/bounty-submissions/bounty-submission) | Work submitted to a bounty, from attempt to payout. |

### Chat

Channels, the messages exchanged within them, and the notifications users receive.

| Resource | What it's for |
| - | - |
| [Notifications](/api-reference/beta/notifications/notification) | The user's notification feed: unread badges, mark-read, app sends, and the topic catalog. |

### Media

Generate media assets from your integration.

| Resource | What it's for |
| - | - |
| [Files](/api-reference/beta/files/file) | Upload files and attach them wherever Whop accepts documents. |
| [Media](/api-reference/beta/media/media) | AI-generated assets, billed from a balance, attachable wherever files are accepted. |

### Developer

Credentials, webhooks, and logs for integrating with the Whop API.

| Resource | What it's for |
| - | - |
| [API Keys](/api-reference/beta/api-keys/api-key) | Programmatic credentials for an account or app. |
| [Webhooks](/api-reference/beta/webhooks/webhook) | Event notifications pushed to your server as things happen. |
| [Permissions](/api-reference/beta/permissions/permission) | What your credential is allowed to do on a resource. |
| [API Logs](/api-reference/beta/api-logs/api-log) | Requests made to Whop's API with your account's API keys. |
| [Feedback](/api-reference/beta/feedback/feedback) | Issues and unanswered questions sent to Whop for review. |


## Related topics

- [Overview](/api-reference/beta/ads/overview.md)
- [Payments Overview](/developer/payments/overview.md)
- [ChatElement](/sdk/elements/chat-element.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.