Edit this page

Get Records for Multiple Domains

Copy
Copied
https://resolve.unstoppabledomains.com/records

This endpoint returns all the records attached to multiple domain names in a single response.

Request Method

  • GET

Authentication

  • Bearer Token

Query Params

Name Type Mandatory Description
domains ARRAY[STRING] YES A list of UD domains to query for resolution records
key STRING NO The resolution record to retrieve across the requested domains. See the Records Reference documentation for supported values
info

To retrieve the records of multiple domains, you need to use a new domains query param instance for each domain name.

Returns

An object with a data field that contains a list of domains and resolution records.

  • data : (array) An array with the data and metadata of domains owned by a wallet address.
    • domain : (string) Name of the domain.
    • 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.

Example

Here is an example request to query for a specific resolution record from multiple domain names:

  1. brad.crypto
  2. matt.crypto
  3. crypto.ETH.address
RequestResponse
Copy
Copied
curl \
--request GET 'https://resolve.unstoppabledomains.com/records?domains=brad.crypto&domains=matt.crypto&key=crypto.ETH.address' \
--header 'Authorization: Bearer {SECRET_API_TOKEN}'
Copy
Copied
{
  "data": [
    {
      "domain": "brad.crypto",
      "records": {
        "crypto.ETH.address": "0x8aaD44321A86b170879d7A244c1e8d360c99DdA8"
      }
    },
    {
      "domain": "matt.crypto",
      "records": {
        "crypto.ETH.address": "0xa59C818Ddb801f1253edEbf0Cf08c9E481EA2fE5"
      }
    }
  ]
}

Asking For Help

If you are experiencing difficulties using our services, please know that we are here to help. You can join our Discord Community for real-time support from UD and the community, where you can receive assistance with integrating your app