dns
ddns

Suggest alternative free Dynamic DNS hostnames

Suggest alternative labels available under a free Dynamic DNS parent domain, for when the requested one is taken or invalid. Returns bare LABELS, not full hostnames. Each is checked against the same rules a claim applies, but availability can still change before you claim.

get/dns/ddns/free-hostnames/suggest

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/dns/ddns/free-hostnames/suggest
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

labelstring required
parentDomainstring required

Headers

x-namefi-eip7702-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-accountstring

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.