Skip to main content

Get ENS Record By Name

POST
Retrieves ENS domain information by entering the ENS domain name.

🚧 Please verify the network when using!

This API is supported only on Ethereum Mainnet and cannot be used on other networks. Please verify the network when using.

Path Parameters
chainstringrequired
Parameter specifying the target chain to query.
networkstringrequired
Parameter specifying the network of the target chain.
Request Body
namestringrequired
Enter the ENS domain name.
Responses
namestringrequired
A field representing the name of the ENS domain.
isMigratedbooleanrequired
A field indicating whether the ENS domain has been migrated to the latest version. If true, the domain has been migrated to the latest version; if false, the domain has not been migrated. Migration status is important for domain management and compatibility.
isPrimaryNamebooleanrequired
A field indicating whether the ENS domain is the Primary Name. In the ENS structure, multiple domains can be linked to a single address, and the primary domain is called the Primary Name. If true, the domain is registered as Primary Name; if false, it indicates a non-Primary domain.
nodestringrequired
A field representing the unique identifier of the ENS domain, which is a hash value generated by the namehash algorithm. For example, if the domain name is example.nodit.eth, the node value is generated as namehash('example.nodit.eth'). Provided as a 64-character hexadecimal string prefixed with 0x.
labelNamestringrequired
A field representing the lowest-level label of the domain name. For example, for example.nodit.eth, labelName is 'example'.
labelHashstringrequired
A field representing the hash value of the lowest-level label of the domain name. For example, for example.nodit.eth, labelHash is generated as keccak256('example'). Provided as a 64-character hexadecimal string prefixed with 0x. <br/> <strong style='color: red;'>*</strong> For wrapped domains, the address shown in ownerAddress may be the wrapping contract address. Please refer to the wrappedOwnerAddress field to verify the actual owner address.
ownerAddressstringrequired
A field representing the owner address of the ENS domain. Provided as a 40-character hexadecimal string prefixed with 0x. <br/> <strong style='color: red;'>*</strong> The owner address indicates the owner of the domain and may differ from the address the domain is linked to. For asset transfers, please refer to resolvedAddress in the resolver field.
A field representing the Resolver information of the domain.
contractAddressstringrequired
A field representing the Resolver contract address of the domain. Provided as a 40-character hexadecimal string prefixed with 0x.
resolvedAddressstringrequired
A field representing the address the domain is linked to. Provided as a 40-character hexadecimal string prefixed with 0x. <br/> <strong style='color: red;'>*</strong> resolvedAddress may differ from the owner address. Please refer to the ownerAddress field to verify the actual owner address of the domain.
contentHashstringrequired
A field representing the content hash of the domain. Stores various forms of content hash including IPFS hashes in ERC-1577 format. This field provides the decoded result.
textobjectrequired
A field representing the text record information of the domain. Text records are fields that can store various information about the domain; ENS domain owners can store any desired information. <br/> <strong style='color: red;'>*</strong> Different text records may exist for each domain. If no text record exists, this field is provided as an empty object.
A field representing the registration information of the domain.
registrantAddressstringrequired
A field representing the address that registered the domain. Provided as a 40-character hexadecimal string prefixed with 0x.
registrationDatestringrequired
A field representing the registration date of the domain. Provided in ISO 8601 format (YYYY-MM-DDThh:mm:ss{time zone}).
expiryDatestringrequired
A field representing the expiry date of the domain. Provided in ISO 8601 format (YYYY-MM-DDThh:mm:ss{time zone}).
coststringrequired
A field representing the registration cost of the domain in Wei. Provided in decimal string format.
A field representing the wrapped domain information. For wrapped domains, the ownerAddress field displays the wrapping contract address. Please refer to the wrappedOwnerAddress field to verify the actual owner address.
contractAddressstring
A field representing the wrapping contract address of the domain. Provided as a 40-character hexadecimal string prefixed with 0x. If the domain is not wrapped, this field is provided as null.
wrappedOwnerAddressstring
A field representing the owner address of the wrapped domain. Provided as a 40-character hexadecimal string prefixed with 0x. If the domain is not wrapped, this field is provided as null.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "MISSING_REQUIRED_PARAMETER",
  "message": "Missing required parameter: { PARAMETER_NAME }"
}
cURL
curl -X POST 'https://web3.nodit.io/v1/ethereum/mainnet/ens/getEnsRecordByName' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "name": "vitalik.eth"
  }'