Docs / built-apps / DomainSearchResult

DomainSearchResult

typesince 0.3.1not for built apps

One TLD's availability + Casino retail price from searchDomains (P0-163).

import type { DomainSearchResult } from 'flowstack-sdk'

A single row of a searchDomains response: whether {name}.{tld} is available and what Casino charges per year. available is tri-state — null means the lookup for this TLD failed (transient), which is NOT the same as taken.

Signature

interface DomainSearchResult

Returns

FieldTypeDescription
domainstringThe full domain checked, e.g. thezengarden.com.
tldstringThe TLD for this row, e.g. com.
availableboolean | nulltrue = purchasable, false = taken, null = the lookup for this TLD failed — retry or show an unknown state, never "taken".
price_usdnumber | nullCasino retail price per year (markup included); null when unknown.
aws_cost_usdnumber | null?Underlying Route 53 cost per year, when surfaced.
WarningTreat available: null as "unknown", not "taken" — rendering failed lookups as taken silently loses sales during registrar blips.

See also

searchDomains · purchaseDomain · PurchaseDomainRequest

Source: src/types/index.ts (Domain Registrar, P0-163) · Also available in llms-full.txt and registry.json.