Domain name availability check

Checks whether a domain name is registered — and, when it is, who holds it and when it expires — straight off RDAP, the IANA-standardized WHOIS successor.

Checks whether a domain name is registered — and, when it is, who holds it and when it expires — straight off RDAP, the IANA-standardized WHOIS successor. No key, no browser. Price is currently always unknown; see the result's warnings.

Also known as: domain availability, is this domain available, check if a domain is available, domain name check, domain registration check, whois lookup, rdap lookup, buy a domain, register a domain, domain price

Call it

bowmark.domain.checkAvailability(name: string): Promise<DomainAvailabilityResult>

Functions

Function	What it does
`checkAvailability`	Looks up a domain name (e.g. "example.com") against its authoritative RDAP server and reports whether it is registered, plus the registrar and registration/expiration dates when it is.

Types

interface DomainAvailabilityResult {
  name: string                  // normalized: lowercased, no scheme, no "www."
  available: boolean | null     // true = free, false = registered, null = unknown
  registrar: string | null
  registeredAt: string | null   // ISO 8601
  expiresAt: string | null      // ISO 8601
  price: null                   // always null — see warnings
  currency: null
  source: string                // "rdap"
  warnings: string[]
}

Examples

// A bare domain — what a "is this name taken" check already has.
const { available, registrar, expiresAt } = await bowmark.domain.checkAvailability("example.com");
if (available) {
  log("example.com looks free to register");
} else {
  log(`example.com is registered via ${registrar}, expires ${expiresAt}`);
}
return { available, registrar, expiresAt };

Providers behind it

None — this capability needs no site. It computes the answer, or reads a public API that publishes it.