Get records for a domain
Gets all the records attached to a domain name.

Get records for a domain

1
GET https://unstoppabledomains.g.alchemy.com/domains/<domain name>
Copied!
The domains endpoint is the main endpoint to resolve Unstoppable domain names into records. The endpoint will return all configured resolution records in a single response.

URL Params

Name
Type
Mandatory
Description
domain name
STRING
YES
A domain name registered by Unstoppable Domains. See all the supported domain endings
The resolution service will not return an error in the case of an invalid domain or unsupported domain ending to simplify communication.

Query Params

  • none

Returns

A single object with the following fields:
  • records: a key-value dictionary with all domain records set on-chain. This includes wallet addresses and IPFS website hashes. To get more details, visit the Unstoppable Domains Records Reference section.
  • meta: a key-value dictionary with general information about the domain:
    • domain: (string) domain name.
    • blockchain: (string) the blockchain the domain is located (MATIC, ETH, ZIL). The blockchain names are coin types according to SLIP-0044.
    • networkId: (number) the blockchain network ID.
      • 1 - Ethereum or Zilliqa Mainnet
      • 137 - Polygon (Matic) Mainnet
      • 80001 - Polygon (Matic) Mumbai Testnet
      • 4 - Ethereum Rinkeby Testnet
      • 5 - Ethereum Goerli Testnet
  • owner: (string) the wallet address that owns the domain.
  • resolver: (string) the Resolver smart contract address. This contract is responsible for managing domain records.
  • registry: (string) the Registry smart contract address. Registry manages domain ownership, minting domains and subdomains, storing domain metadata, and burning domains. The registry also stores and manages domain records in the Unstoppable Name Service (UNS).

Example

Here is an example request to query for the records and metadata of the brad.crypto domain.

Request

1
curl \
2
--request GET 'https://unstoppabledomains.g.alchemy.com/domains/brad.crypto' \
3
--header 'Authorization: Bearer <YOUR API KEY>'
Copied!

Response

1
{
2
"records": {
3
"ipfs.html.value": "QmVHmG6BDRsDuzcFrWw6m5ByDnzcvfQbmdQF9bbSFTUeD1",
4
"crypto.ADA.address": "DdzFFzCqrhsuwQKiR3CdQ1FzuPAydtVCBFTRdy9FPKepAHEoXCee2qrio975M4cEbqYwZBsWJTNyrJ8NLJmAReSwAakQEHWBEd2HvSS7",
5
"crypto.BTC.address": "bc1q359khn0phg58xgezyqsuuaha28zkwx047c0c3y",
6
"crypto.ETH.address": "0x8aaD44321A86b170879d7A244c1e8d360c99DdA8",
7
"gundb.username.value": "0x8912623832e174f2eb1f59cc3b587444d619376ad5bf10070e937e0dc22b9ffb2e3ae059e6ebf729f87746b2f71e5d88ec99c1fb3c7c49b8617e2520d474c48e1c",
8
"social.picture.value": "1/erc1155:0xc7e5e9434f4a71e6db978bd65b4d61d3593e5f27/14317",
9
"gundb.public_key.value": "pqeBHabDQdCHhbdivgNEc74QO-x8CPGXq4PKWgfIzhY.7WJR5cZFuSyh1bFwx0GWzjmrim0T5Y6Bp0SSK0im3nI",
10
"ipfs.redirect_domain.value": "https://abbfe6z95qov3d40hf6j30g7auo7afhp.mypinata.cloud/ipfs/Qme54oEzRkgooJbCDr78vzKAWcv6DDEZqRhhDyDtzgrZP6"
11
},
12
"meta": {
13
"domain": "brad.crypto",
14
"blockchain": "ETH",
15
"networkId": 1,
16
"owner": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
17
"resolver": "0xb66dce2da6afaaa98f2013446dbcb0f4b0ab2842",
18
"registry": "0xd1e5b0ff1287aa9f9a268759062e4ab08b9dacbe"
19
}
20
}
Copied!