Waitlist Entry

A Waitlist Entry is a user’s signup for a variant that requires seller approval. Joining doesn’t grant a membership or charge a payment method; the seller approves or denies each signup. Use the Waitlist Entries API to join a waitlist, read or cancel your own signups, and approve or deny the signups for accounts you operate.

Endpoints

Endpoint	Request
List Waitlist Entries	GET `/waitlist_entries`
Retrieve Waitlist Entry	GET `/waitlist_entries/{id}`
Create Waitlist Entry	POST `/waitlist_entries`
Approve Waitlist Entry	POST `/waitlist_entries/{id}/approve`
Cancel Waitlist Entry	POST `/waitlist_entries/{id}/cancel`
Deny Waitlist Entry	POST `/waitlist_entries/{id}/deny`
Approve All Waitlist Entries	POST `/waitlist_entries/approve_all`

Attributes

string

required

The waitlist signup ID, prefixed entry_.

string

required

The seller account, prefixed biz_.

string | null

required

Why the last approval attempt failed, or null when none has. plan_unavailable — the variant, product, or seller account was deleted. already_member — the user already has a membership on a one-per-user product. checkout_failed — checkout failed, usually a declined payment, and the signup was denied. unknown — another failure; retry. Cleared when approval is requeued.Available options: plan_unavailable, already_member, checkout_failed, unknown

object | null

required

The account the signup was submitted on behalf of, or null when the user signed up for themselves.

Properties

string

required

Account ID, prefixed biz_.

string | null

required

Account logo image URL. null when the account has not set one.

string

required

Account public route identifier — the whop.com/\{route} storefront path.

string

required

Account display name.

string | null

required

The account the signup was submitted on behalf of, prefixed biz_, or null when the user signed up for themselves.

string

required

When this signup was submitted, as an ISO 8601 timestamp.

object[]

required

The buyer’s answers to checkout questions.

Properties

string

required

The answer’s ID, prefixed cfrp_.

string

required

The buyer’s answer.

string

required

The question shown when the signup was submitted.

string | null

required

The membership created for this signup, prefixed mem_, or null when there is none. Check the membership’s status to determine access.

object

required

Custom key-value metadata associated with this signup.

object | null

required

The product this signup belongs to, or null when the variant has no product.

Properties

string

required

Product ID, prefixed prod_.

string

required

Product display name.

string | null

required

The product this signup belongs to, prefixed prod_, or null when the variant has no product.

string

required

The signup’s current state. Approval runs asynchronously, so a signup stays pending until processing completes. approved alone does not prove an active membership; check membership_id.Available options: pending, approved, denied, canceled

string

required

When this signup last changed, as an ISO 8601 timestamp.

object

required

The user who submitted this signup. For a signup an account’s own credential submitted, the account’s owner.

Properties

string

required

User ID, prefixed user_.

string | null

required

Display name.

object

required

Avatar wrapper; its url is always present, using a generated placeholder when the user set no picture.

Properties

string

required

Avatar image URL. Always present — a generated placeholder when the user set no picture.

string

required

Public username.

string

required

The user who submitted this signup, prefixed user_. For a signup an account’s own credential submitted, the account’s owner.

object

required

The variant this signup belongs to.

Properties

string

required

Variant ID, prefixed plan_.

number | null

required

Number of days between recurring charges, such as 30 for monthly or 365 for annual. null for one-time variants.

string

required

Billing model for this variant: one_time or renewal.Available options: renewal, one_time

string | null

required

Customer-visible variant description. Maximum 1000 characters. null if no description is set.

object

required

What checkout charges up front. amount is "0.00" when the first charge is free, such as a trial.

Properties

string

required

The amount in major units, as an exact decimal string — "10.00" is ten dollars. A string so no float rounds it in transit.

string

required

Three-letter ISO 4217 currency code, lowercase.

integer

required

How many decimal places the amount CARRIES — the precision the charge itself runs at.

integer

required

How many decimal places to SHOW. Usually equal to decimals, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is 2 and 0. Format the number in your own locale using this.

object

required

The recurring charge every billing_period days. amount is "0.00" for one-time variants.

Properties

string

required

The amount in major units, as an exact decimal string — "10.00" is ten dollars. A string so no float rounds it in transit.

string

required

Three-letter ISO 4217 currency code, lowercase.

integer

required

How many decimal places the amount CARRIES — the precision the charge itself runs at.

integer

required

string | null

required

Variant display name shown to customers. null if no title has been set.

number | null

required

Free trial days configured before the first renewal charge. null if no trial is configured.

string

required

The variant this signup belongs to, prefixed plan_.

WaitlistEntry

{
	"id": "entry_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxxx",
	"product": {
		"id": "prod_xxxxxxxxxxxxxx",
		"title": "Pro Community"
	},
	"variant_id": "plan_xxxxxxxxxxxxxx",
	"variant": {
		"id": "plan_xxxxxxxxxxxxxx",
		"title": "Monthly",
		"description": "Billed monthly. Cancel anytime.",
		"billing_type": "renewal",
		"billing_period": 30,
		"initial_price": {
			"currency": "usd",
			"amount": "10.00",
			"decimals": 2,
			"display_decimals": 2
		},
		"renewal_price": {
			"currency": "usd",
			"amount": "10.00",
			"decimals": 2,
			"display_decimals": 2
		},
		"trial_period_days": 7
	},
	"user_id": "user_xxxxxxxxxxxxxx",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"username": "jordan_lee",
		"name": "Jordan Lee",
		"profile_picture": {
			"url": "https://img.whop.com/jordan.png"
		}
	},
	"buyer_account_id": null,
	"buyer_account": null,
	"status": "approved",
	"membership_id": "mem_xxxxxxxxxxxxxx",
	"approval_failure_reason": null,
	"custom_field_responses": [
		{
			"id": "cufi_xxxxxxxxxxxxxx",
			"question": "What car do you drive?",
			"answer": "2021 Tesla Model 3"
		}
	],
	"metadata": {},
	"created_at": "2026-09-12T10:15:00.000Z",
	"updated_at": "2026-09-13T08:02:44.000Z"
}

Introduction

Reference

Core Resources

Payments

Money

Commerce

Websites

Ads

Analytics

Communication

Partners

Workforce

Media

Developer

Endpoints

Attributes

​Endpoints

​Attributes

Endpoints

Attributes