Check domain availability
check_availabilityCheck one exact domain. Cloudflare answers first; configured fallbacks, then an optional selected registrar, run only for missing facts; a taken name ends the chain. Returns separate availability and nullable premium facts, provider attempts and check times; null premium is unconfirmed, not standard tier. Recheck after expiresAt (5 min; up to 30 days if taken). No prices, purchase or reservation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tld | Yes | One covered ASCII top-level extension, such as com or .com. Multi-part suffixes and IDNs are not covered. | |
| name | Yes | One ASCII domain label without the extension, such as myproject. Price and link tools only build links from it; availability and popularity tools send the exact domain to their providers. | |
| fresh | No | Explicitly request a fresh single-name recheck only when the user asks. Normal checks reuse saved evidence: five minutes, or up to 30 days for a name found taken. Fresh checks still obey provider gates, pending claims, caller limits and cooldowns; never use in a loop. | |
| registrar | No | Connected registrar ID from the registrars endpoint. Omit to compare all. |