Skip to content
Resolution/
/
Get domains list

Resolution Service (1.0.0)

The Resolution Service provides APIs for resolving domain metadata and records from multiple blockchain and naming services. The service currently supports the following naming services:

  • Unstoppable Domain's UNS and CNS with TLDs: .x, .polygon, .nft, .crypto, .blockchain, .bitcoin, .dao, .888, .wallet, .binanceus, .hi, .klever, .kresus, .anime, .manga, .go, .zil

  • Ethereum Naming Service - ENS with TLDs: .eth



The service caches blockchain events in a database for easy retrieval without accessing any blockchain APIs. With the Resolution Service API, you can quickly build applications directly communicating with the blockchain to get UD domain data with a single API request.
Overview
Unstoppable Domains (Partner Engineering)
partnerengineering@unstoppabledomains.com
Languages
Servers
Production
https://api.unstoppabledomains.com/resolve/
Sandbox
https://api.ud-sandbox.com/resolve/

Domains

Operations

Get domain

Request

Get Records for a Domain
Note: The API should be used in a backend system. If you need the data in client apps, please build a proxy backend to hide the API key.

Security
apiKeyAuth
Path
domainNamestring[^\/#\?]+?required

A domain name registered by Unstoppable Domains

curl -i -X GET \
  'https://api.unstoppabledomains.com/resolve/domains/{domainName}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json
metaobject(DomainMetadata)required
meta.​resolverstring
meta.​blockchainstring
meta.​networkIdnumber
Enum15137133780001
meta.​registrystring
meta.​typestringrequired
Enum"Uns""Zilliqa""Ens"
meta.​customMetaobject
meta.​domainstringrequired
meta.​namehashstring
meta.​tokenIdstring
meta.​ownerstring
meta.​reversebooleanrequired
recordsobjectrequired
Response
application/json
{
  "meta": {
    "resolver": "string",
    "blockchain": "string",
    "networkId": 1,
    "registry": "string",
    "type": "Uns",
    "customMeta": {},
    "domain": "string",
    "namehash": "string",
    "tokenId": "string",
    "owner": "string",
    "reverse": true
  },
  "records": {}
}

Get domains list

Request

Get Records for Multiple Domains

The API only supports Unstoppable Domains' naming services for backward compatibility. A new API version is coming soon for other naming services

  • Unstoppable Domain's UNS and CNS with TLDs: .x, .polygon, .nft, .crypto, .blockchain, .bitcoin, .dao, .888, .wallet, .binanceus, .hi, .klever, .kresus, .anime, .manga, .go, .zil

  • Unstoppable Domain's Zilliqa with TLDs: zil


**Note:** The API should be used in a backend system. If you need the data in client apps, please build a proxy backend to hide the API key.
Security
apiKeyAuth
Query
resolutionobject

See this list for all the resolution keys supported

ownersobject

Wallet addresses of the owners of domains

tldsobject

Domain ending supported such as crypto, x, or polygon. See supported tlds for the full list

sortBystring

Sort key to specify how the returned domain list is sorted

Enum"id""name""created_at"
sortDirectionstring

Sort order of the returned domain list

Enum"ASC""DESC"
startingAfterstring[ 1 .. 200 ]

Query offset to skip a number of record, example: 100

perPagenumber

Number of domains returned in the list, example: 50

curl -i -X GET \
  'https://api.unstoppabledomains.com/resolve/domains?resolution%5Bdata%5D=string&data=string%2Cx&sortBy=id&sortDirection=ASC&startingAfter=string&perPage=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful response

Bodyapplication/json
dataArray of objects(DomainResponse)
metaobject
Response
application/json
{
  "data": [
    { … }
  ],
  "meta": {}
}

Get domains last transfer

Request

Get Domain Transfer Events
Note: The API should be used in a backend system. If you need the data in client apps, please build a proxy backend to hide the API key.

Security
apiKeyAuth
Path
domainNamestring[^\/#\?]+?required

A domain name registered by Unstoppable Domains

curl -i -X GET \
  'https://api.unstoppabledomains.com/resolve/domains/{domainName}/transfers/latest' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful response

Bodyapplication/json
dataArray of objects(DomainLatestTransfer)
Response
application/json
{
  "data": [
    { … }
  ]
}

Get domains records

Request

Get Records for Multiple Domains
It's recommended to use this API on different naming services as they support different record keys

  • Unstoppable Domain's UNS and CNS with TLDs: .x, .polygon, .nft, .crypto, .blockchain, .bitcoin, .dao, .888, .wallet, .binanceus, .hi, .klever, .kresus, .anime, .manga, .go, .zil
    See this list for all the resolution keys supported

  • Ethereum Naming Service - ENS with TLDs: .eth
    See Ens' document for all the resolution keys supported


**Note:** The API should be used in a backend system. If you need the data in client apps, please build a proxy backend to hide the API key.
Security
apiKeyAuth
Query
domainsobject<= 50 itemsrequired

Domain names registered by Unstoppable Domains. At least 1 domain must be passed in

domains.​dataArray of strings
keystring

Filtered resolution key. See above to see the supported keys on different naming services

curl -i -X GET \
  'https://api.unstoppabledomains.com/resolve/records?data=string&key=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful response

Bodyapplication/json
dataArray of objects(DomainRecords)
Response
application/json
{
  "data": [
    { … }
  ]
}

Reverse

Operations

Rpc Proxy

Operations

Status

Operations

Owner

Operations