registration buys the domain through Whop, runs its DNS, and renews it every year; verification connects a domain registered elsewhere once you publish the DNS records it returns, and expires if ownership is not proven within 48 hours; website serves one of the account’s apps on it.
Use the Domains API to search for a domain to buy, buy or connect one, serve a website on it, and check its DNS, payment, and renewal state. Thirty days before a bought domain expires, Whop opens a renewal charge at purchase_url and, while auto_renew is on, charges the saved card. An unpaid domain stops serving when it expires but stays renewable at purchase_url until the registry’s grace period ends, and is then removed.
Endpoints
Attributes
Offering Apple Pay at checkouts served from the domain.
null when not enrolled or not visible to you.Whether you can register the hostname and what it costs. Set only when no domain on Whop has it.
Properties
Properties
Whether the registry charges more than its standard price for this domain.
What the first year of registration costs.
null when the domain is not available.Properties
Properties
The amount in major units, as an exact decimal string. For example,
"10.00"
is ten dollars. It is a string so that no float rounds it in transit.How many decimal places the amount carries. This is the precision the charge
itself runs at.
What each yearly renewal costs after the first year.
null when the domain is not available.Properties
Properties
The amount in major units, as an exact decimal string. For example,
"10.00"
is ten dollars. It is a string so that no float rounds it in transit.How many decimal places the amount carries. This is the precision the charge
itself runs at.
How desirable the domain is, from 0 to 100. Short, real-word names on
well-known extensions score highest.
What moving the domain to Whop costs if it’s registered elsewhere, including the year it adds to the domain’s registration.
null when it’s available or can’t be transferred.Properties
Properties
The amount in major units, as an exact decimal string. For example,
"10.00"
is ten dollars. It is a string so that no float rounds it in transit.How many decimal places the amount carries. This is the precision the charge
itself runs at.
Sending and receiving email on the domain through Whop.
null when not wanted, or when the domain belongs to an account you can’t read.Properties
Properties
pending while Whop sets the domain up with its email provider and publishes its DNS records, ready once the provider verified them, and action_required when it couldn’t; its issue says what happens next. releasing while Whop removes email from the domain.Available options: pending, ready, action_required, releasingWhat needs attention, each tagged with its capability. Empty when nothing does or when the domain isn’t yours.
Properties
Properties
The capability the issue is about.Available options:
verification, registration, platform, subdomain, website, apple_pay, pixel, email, transferWhat needs attention, as a stable code.Available options:
verification_required, verification_expired, ownership_conflict, ownership_lost, dns_required, provider_validation, certificate_pending, expiring_soon, account_unavailable, check_failed, purchase_expired, domain_unavailable, unsupported_tld, registration_unavailable, registration_failed, renewal_failed, payment_action_required, domain_on_whop, domain_transfer_unavailable, transfer_locked, transfer_auth_code_rejected, transfer_rejected, transfer_not_cancellable, domain_transfer_failed, transfer_out_locked, registrar_unavailable, apple_pay_unverified, pixel_not_seen, pixel_not_installed, pixel_waiting, pixel_unreachable, pixel_quiet, email_needs_whop_dns, email_unreachable, email_identity_in_use, email_verification_failed, subdomain_needs_whop_domain, root_domain_pending, root_domain_needs_actionCode to add to the site to fix the issue, ready to copy.
null when the issue
needs none.Custom string keys and values attached to this domain. Empty when the domain
isn’t yours.
The account that has proven it owns this hostname on Whop, which can be your own.
null when no account has.Tracking page views on the domain with the Whop pixel.
null when not tracked or not visible to you.An address on a zone Whop runs, such as example.whop.site, that follows its app’s route.
null for other domains or when not visible to you.The domain’s public registration record (RDAP), read when you retrieve it by hostname.
null for domains on Whop, available domains, or a record that couldn’t be read.Properties
Properties
Whether the domain’s delegation is signed with DNSSEC, or
null when the
registry doesn’t say.When the current registration expires, as an ISO 8601 timestamp, or
null
when the record omits it.The name servers the domain delegates to, lowercase, such as
ns1.example.com. Empty when the record lists none.When the domain was first registered, as an ISO 8601 timestamp, or
null when
the record omits it.Who the domain is registered to, often a privacy service or
Redacted For Privacy. null when the record publishes no registrant.Properties
Properties
Registrant postal address as published, with lines separated by line breaks.
Often only a state or region.
null when withheld.A web form for contacting the registrant, published when the registrar
withholds their email.
null when there is none.Registrant country as an ISO 3166-1 alpha-2 code, such as
US, or null when
withheld.Registrant email address, often a privacy forwarding address, or
null when
withheld.The registrar that manages the domain, or
null when the record doesn’t name one.The domain’s registry statuses in RDAP form, such as
client transfer prohibited. Empty when the record lists none.Buying the domain through Whop, renewing it, and running its DNS.
null when not wanted or not visible to you.Properties
Properties
What the domain owes now.
null when nothing is owed.Properties
Properties
The amount in major units, as an exact decimal string. For example,
"10.00"
is ten dollars. It is a string so that no float rounds it in transit.How many decimal places the amount carries. This is the precision the charge
itself runs at.
When the registration expires unless renewed, as an ISO 8601 timestamp.
null
until it’s registered.How the domain came to Whop:
registration when it was bought through Whop, transfer when it was moved from another registrar.Available options: registration, transferID of the saved card charged for the domain, prefixed
payt_. null when
none is set.Where the registration is: awaiting payment, ordering at the registrar, transferring from another registrar, delegating DNS to Whop, held, expired, or releasing.Available options:
awaiting_payment, ordering, transferring, delegating, held, expired, failed, releasingLink to pay what the domain owes now: its registration or transfer, or a
yearly renewal.
null when nothing is owed.What each yearly renewal costs at the registrar’s current price. Set when the response is a single domain;
null in lists, while the domain is being released, or when the price can’t be read right now.Properties
Properties
The amount in major units, as an exact decimal string. For example,
"10.00"
is ten dollars. It is a string so that no float rounds it in transit.How many decimal places the amount carries. This is the precision the charge
itself runs at.
The most pressing state of the domain’s capabilities:
releasing, then action_required, then pending, then ready. idle when it wants nothing.Available options: idle, pending, ready, action_required, releasingA subdomain of a domain this account bought through Whop, whose DNS Whop runs. Whop removes it when the account no longer holds the root domain.
null for other domains or when not visible to you.Moving the domain out of this account, to another Whop account or another registrar.
null when not turned on or not visible to you.Properties
Properties
The code that takes the domain, shown while
state is ready. For an
internal move it starts whop_dt_. The receiving Whop account enters it as
registration.auth_code when it creates or updates the domain. For an
external move it is the registrar’s auth code, which you give to the new
registrar. Only a single-domain response shows it, and only to a caller who
can manage the domain. Otherwise it is null.Where the domain is moving.
internal is another Whop account. external is another registrar.Available options: internal, externalready while the code waits to be used. For internal, pending once another account uses it. Whop then removes the domain’s email, Apple Pay and pixel from this account. Then it moves the registration and removes the domain from this account. For external, pending while Whop unlocks the domain at its registrar and turns off everything Whop runs on it. The domain leaves this account when the transfer completes. releasing while Whop turns the transfer off.Available options: ready, pending, releasingProving you control the domain’s DNS with a TXT record.
null when not wanted or not visible to you.Serving a Whop website on the domain.
null when not wanted.Properties
Properties
Domain

