Skip to main content

Get ENS Records By Account

POST
Retrieves ENS domain information by entering the ENS domain owner address or the address that the domain points to. ownerAddress indicates the ENS domain owner address, and resolvedAddress indicates the address that the ENS domain points to.

🚧 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
pageinteger
The page parameter specifies the data page to query. It accepts values up to 100; for pages exceeding 100, use the cursor pagination method.The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.
rppinteger
rpp stands for results per page and specifies the page size. You can specify a number greater than 0 and up to 100.
cursorstring
The cursor parameter supports pagination and data navigation between pages. Provide the cursor value from the previous page in the next request to load the next page of data.The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.
withCountboolean
Parameter specifying whether to include the count field in the response. The count field indicates the total number of requested data items. When set to true, the count field is included and response speed may be slower.
Responses
pageinteger
Field representing the page number specified in the page parameter. This field is only included in the response when a value greater than 0 is specified for the page parameter.
rppinteger
Field representing the number of results per page specified in the rpp parameter.
cursorstring
A field for cursor pagination. This value must be provided in the next request to load the next page of data.
countinteger
Field representing the total count of requested data. This field is only included in the response when true is set for the withCount parameter.
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/getEnsRecordsByAccount' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{}'