Domain qube

The domain qube registers, holds, and renews a domain on your behalf, and includes free DNS hosting and DNSSEC.

Capabilities

Capability	Notes
Register	Live registration via the registry. Returns the domain in live state, typically within 90 seconds.
Renew	Manual or auto. Renewal price is the same as the registration price for that ending, plus VAT.
Transfer in	Move a domain you own elsewhere into CloudQube. Requires the auth code from the losing registrar.
Transfer out	Always available, no fee. Generates an auth code on request.
WHOIS lookup	Read-only, included free.
Bulk availability check	Checks multiple endings in one call.
DNS hosting	Included automatically; you do not need to add a DNS qube.
DNSSEC	Signed and DS published to the registry by default.

Inputs at provisioning time

• name (string, required): the domain without an ending, e.g. example.
• extension (string, required): the ending without a dot, e.g. eu.
• auto_renew (boolean, default true): renew automatically when the term expires.
• registrant (object, required): the WHOIS-visible owner block (name, organisation, address, email, phone). Your account profile is used as the default.

Outputs (provisioned resources)

• domain (string): the registered domain, e.g. example.eu.
• registered_at (timestamp): when the registration completed.
• expires_at (timestamp): the end of the current registration term.
• auto_renew (boolean): current auto-renew state.
• dnssec_status (enum): pending, active, chain_verified, disabled.

Billing surface

• One-shot charge at registration: registry fee + CloudQube margin + VAT.
• One-shot charge at every renewal: same shape.
• DNS hosting and DNSSEC are free regardless of how many records you store.
• WHOIS lookups are free.

Errors

Code	Meaning	What to do
domain_taken	Someone else owns it	Pick a different name or check WHOIS
extension_unsupported	We do not register this ending	Pick a different ending
registry_offline	The registry is not reachable	Retry later
registrant_invalid	WHOIS validation failed at the registry	Fix the registrant block, retry
premium_quote_expired	The premium quote we showed you is no longer valid	Re-search to get a fresh quote

Linked qubes

• The DNS qube is auto-installed on registration and shares state with the domain qube.
• The email qube and container qube can attach to a domain qube to publish records and route custom domains automatically.