Edit this page

Get Reverse Record for an Address

https://resolve.unstoppabledomains.com/reverse/<wallet address>

This endpoint will return the reverse record of the wallet address and all the domain name records and domain metadata in a single response.

Request Method

  • GET

URL Params

Name Type Mandatory Description
wallet address STRING YES A wallet address to query for reverse record

Query Params

  • none


An object with the following fields:

  • meta : A key-value dictionary with general information about the domain:
    • domain : (string) domain name.
    • 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).
    • 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
  • 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 documentation.


Here is an example request to query for the reverse record for the "0x3EAA674612f79A97ad451fCF860A51Ad41aC2C19" wallet address:


curl \
--request GET "https://resolve.unstoppabledomains.com/reverse/0x3EAA674612f79A97ad451fCF860A51Ad41aC2C19" \
--header 'Authorization: Bearer <YOUR API KEY>'


  "meta": {
    "domain": "reseller-test-udtesting-034215839398.crypto",
    "blockchain": "MATIC",
    "networkId": 137,
    "owner": "0x3eaa674612f79a97ad451fcf860a51ad41ac2c19",
    "resolver": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f",
    "registry": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f"
  "records": {
    "crypto.ETH.address": "0x3eaa674612f79a97ad451fcf860a51ad41ac2c19",
    "crypto.MATIC.version.ERC20.address": "0x3eaa674612f79a97ad451fcf860a51ad41ac2c19",
    "crypto.MATIC.version.MATIC.address": "0x3eaa674612f79a97ad451fcf860a51ad41ac2c19"

Asking For Help

Having troubles using our services? We’re here to help. Join our Discord Community for real-time support from UD and the community if you need assistance integrating your app.