Skip to main content
POST
Check Domain

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-10-08"

Path Parameters

id
string
required

Domain ID, prefixed dom_.

Response

Domain check started

account_id
string | null
required

ID of the account the domain belongs to, prefixed biz_.

Example:

"biz_xxxxxxxxxxxxxx"

availability
object | null
required

Whether you can register the hostname and what it costs. Set only when no domain on Whop has it.

created_at
string | null
required

When the domain was created, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

domain
string
required

Normalized hostname, such as checkout.example.com.

Example:

"shop.com"

id
string | null
required

Domain ID, prefixed dom_. null when no domain on Whop has this hostname.

Example:

"dom_xxxxxxxxxxxxxx"

issues
object[]
required
metadata
object
required

Custom string keys and values attached to this domain. Empty when the domain isn't yours.

Example:
owned_by
object | null
required

The other account that has proven it owns this hostname. null when no other account does.

public_record
object | null
required

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.

registration
object | null
required

Buying the domain through Whop, renewing it, and running its DNS. null when not wanted or not visible to you.

status
enum<string> | null
required

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,
releasing,
null
Example:

"pending"

updated_at
string | null
required

When the domain was last updated, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

verification
object | null
required

Proving you control the domain's DNS with a TXT record. null when not wanted or not visible to you.

website
object | null
required

Serving a Whop website on the domain. null when not wanted.