dns
ddns

Check whether a free Dynamic DNS hostname is available

Check whether a label is available under a free Dynamic DNS parent domain, and if not, why. The answer is ADVISORY: another user may claim the name first, so claimFreeDdnsHostname re-checks and can still fail with "taken".

get/dns/ddns/free-hostnames/check

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/dns/ddns/free-hostnames/check
  • 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.