Domain

Names for sale built from query (a word, or a whole name), in tlds or a common set, with close alternatives: up to limit (10 by default, at most 50), exact matches first, each priced for the TLD's shortest term (minYears), with any trademark claimsNotice.

Register offer in the person's name (yours, or inside asUser the user's) for years, the TLD's minimum when omitted, charged to your account and never to the user, refused with PriceExceeded above maxPriceUsd. A user's domain needs registrant, the person's details with agreementAcceptedAt (InvalidRequest without it); one your account buys for itself, outside asUser, uses the account's default registrant when you pass none (with none set, it throws ActionRequired whose nextStep links to where it's set, and nothing is bought). A name with a claimsNotice needs acceptClaims. NoClick checks your account can pay before registering (PaymentRequired otherwise) and charges it when the registry confirms the registration; one that fails is never charged. A policy hold waits in awaiting_human until the approver answers; nobody answering within 24 hours expires it, and nothing is charged. The price is checked against maxPriceUsd again when it runs.

NoClick's domain registration agreement, which every registrant accepts: its page names the sponsoring registrar, as ICANN requires, and carries the fee schedule (registration, renewal, renewal after expiry, restore) and ICANN's registrant rights and responsibilities. Show it to the person, and record when they accept it as agreementAcceptedAt on their DomainContact: a registration needs it.

The registrant your account's own domains are registered to when a purchase names none (null until set).

Set (or with null clear) the registrant your account's own domains use when a purchase names none, so Domain.buy or Domain.fromName(..., { createIfMissing }) outside asUser needs no contact in code; until one is set, such a purchase throws ActionRequired. A user's domain is still registered to that user: pass their details as registrant. Like any registrant, it needs agreementAcceptedAt.

Connect a domain the person owns (acme.com, or book.acme.com). It's pendingDns until records are added where its DNS is hosted (setupUrl does it in one click where the host supports it). On a bare domain www is primary and the bare name needs CNAME flattening or a forward. wildcard: true adds the *.<name> records too, so every subdomain can serve an app or send an app's email without a record of its own; each goes live once its certificate is issued, usually within minutes of its first use.

Whether name (registered elsewhere) can move to NoClick now, and what it costs. Nothing is charged. NoClick works it out from the domain's public registration data (its registrar lock, its transfer lock, whether NoClick registers the TLD) and the registrar's price, so it's a best answer until transferIn is accepted.

Move name (a name, a TransferQuote, or a domain you connected) to NoClick from its current registrar, with the authCode that registrar gives. It's charged to your account like a purchase once the transfer completes (PriceExceeded above maxPriceUsd, awaiting_human while your policy holds it), and registered to registrant on the same rule as Domain.buy, agreementAcceptedAt included: required for a user's domain, else the account's default registrant. One the registry won't move now throws NotAvailable with the reason. Its nameservers don't change, so its DNS keeps working where it's hosted; once it's active, useNoClickDns() moves the DNS to NoClick. A connected domain keeps its id and what it serves; passed as a Domain, the transfer acts in that domain's own scope (its user, else your account), while a name acts for the current user or user.

A lazy reference to your domain called name; loading one that isn't yours throws NotFound. With createIfMissing your code owns it idempotently: the first time it's used with no such domain it's bought as Domain.buy would (maxPriceUsd is required, years is the TLD's minimum when omitted, and a user's domain needs registrant), and an existing one whose autoRenew differs is updated.

A lazy reference to a domain by id.

Load a domain by id now; an unknown id raises noclick.NotFound.

Your domains, bought and connected (the current user's inside asUser, or those userFilter covers).

One page of domains; pass nextCursor back as cursor.

Check the domain's DNS now; each record's status and the domain's own are as found.

Change a bought domain's settings: { autoRenew: false } lets it lapse at expiresAt, and registrant replaces the details of the person it's registered to. ICANN requires accurate details, so update them when the person's change. Changing the registrant's name, organization or email asks the new registrant to confirm their email again (the domain is registrant_unverified meanwhile) and may start the registry's transfer lock (see transferLockedUntil).

Extend a bought domain now by years, or the TLD's minimum term (renewalYears) when omitted, charged to your account when the renewal lands; like a purchase it may wait in awaiting_human for your policy's approver. After renewableUntil it throws NotAvailable: renewing past the guaranteed renewal window, or restoring a domain the registry is about to delete, isn't an API call (NoClick support may be able to restore it, at the registry's restore fee).

Move a transferred domain's DNS hosting to NoClick: the records NoClick can read where it's hosted now are copied first, then its nameservers change. Resolves to the records copied, for review: add any it missed with dns.set. On a domain whose DNS NoClick already hosts it copies nothing; a connected domain throws NotAvailable (transfer it in first).

Unlock a bought or transferred domain for another registrar; inside the registry's transfer lock (transferLockedUntil) it throws NotAvailable. The code works until its expiresAt.

Disconnect a connected domain (its DNS stays as it is where it's hosted). Throws Conflict while an inbox uses it, and on a bought domain, which can only lapse or transfer out.