Retrieve Domain
Retrieves the claim, app assignment, DNS instructions, and the latest hostname and certificate state. For domains still connecting, needing attention, or being deleted, requests an immediate background check.
Authorizations
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
Pins the request to a dated API version.
"2026-09-29"
Path Parameters
Domain ID, prefixed dom_.
Response
Domain details
ID of the account claiming or owning this domain, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
ID of the app assigned to this domain, prefixed app_.
"app_xxxxxxxxxxxxxx"
Cloudflare's latest certificate issuance status.
null
When the domain claim was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Result of the most recent DNS routing check. Ownership is verified separately.
pending, valid, invalid, unknown "pending"
Normalized hostname, such as checkout.example.com.
"shop.example.com"
Cloudflare's latest hostname activation status.
null
Domain ID, prefixed dom_.
"dom_xxxxxxxxxxxxxx"
When DNS and provider state were last checked, as an ISO 8601 timestamp.
null
Custom string keys and values attached to this domain.
Domain lifecycle. Only active domains resolve to their app.
pending_verification, provisioning, active, action_required, deleting, removed "deleting"
When the domain was last updated, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
When an unverified claim is automatically deleted, 48 hours after creation, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
When Whop verified the ownership TXT record, as an ISO 8601 timestamp.
null

