Interactive NFD lookup

'Looking up' an NFD interactively (debounce)

If you want to provide interactive search features for an NFD. You can use the NFD 'search' endpoint using the prefix query parameter.

The endpoint is the /nfd/v2/search endpoint. It takes many query parameters but only certain types should be specified at one time.

ie: prefix, but not owner or reservedFor.

Search NFDs via various filters

Search NFDs via various filters

GEThttps://api.nf.domains/nfd/v2/search

Query parameters

Header parameters

Response

200304400404429

OK response.

Headers

Body

application/json

match-checkstring

Not returned, used in tagging for response to indicate if-none-match etag matched

nfds*NfdRecordCollection (array of NfdRecord (object))

total*integer (int64)

total number of results, with data containing paged amount based on offset/limit

Request

JavaScriptCurl

const response = await fetch('https://api.nf.domains/nfd/v2/search', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "match-check": "Nesciunt numquam ullam accusantium et debitis autem.",
  "nfds": [
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    },
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    },
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    },
    {
      "appID": 1000000,
      "asaID": 5020498933399342000,
      "avatarOutdated": false,
      "caAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ],
      "cache-control": "Voluptas ea molestiae eligendi et asperiores.",
      "category": "Ut eos aspernatur.",
      "currentAsOfBlock": 2761096942291864600,
      "depositAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "etag": "Sequi dolor fugiat.",
      "match-check": "Vel et enim numquam et qui incidunt.",
      "metaTags": [
        "Saepe libero eum eaque quo assumenda.",
        "Animi voluptatem est minus.",
        "Tenetur reprehenderit sunt adipisci necessitatibus."
      ],
      "name": "Autem ab.",
      "nfdAccount": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "owner": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "parentAppID": 1000000,
      "properties": {
        "internal": {
          "Animi veniam eum esse eos et porro.": "Ullam veritatis qui placeat quo.",
          "Quidem a nesciunt.": "Et alias dolor debitis veniam.",
          "Ut repellendus doloribus omnis quidem sed omnis.": "In aut neque vel."
        },
        "userDefined": {
          "ca:p": "Eveniet architecto consequatur."
        },
        "verified": {
          "caAlgo": "Nostrum ea."
        }
      },
      "reservedFor": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "saleType": "Ad veritatis nobis esse error pariatur veniam.",
      "sellAmount": 4924974612238891000,
      "seller": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "sigNameAddress": "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
      "state": "Nobis nesciunt.",
      "tags": [
        "Necessitatibus necessitatibus molestias cumque veritatis earum non.",
        "Voluptatem quia rerum.",
        "Dolor nesciunt minus sequi.",
        "Laborum voluptas consequatur aliquam doloremque."
      ],
      "timeChanged": "1991-02-07T01:20:39Z",
      "timeCreated": "2015-03-30T18:41:32Z",
      "timePurchased": "2015-12-09T05:54:10Z",
      "unverifiedCa": {
        "btc": [
          "12KKDt4Mj7N5UAkQMN7LtPZMayenXHa8KL"
        ]
      },
      "unverifiedCaAlgo": [
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU",
        "4F5OA5OQC5TBHMCUDJWGKMUZAQE7BGWCKSJJSJEMJO5PURIFT5RW3VHNZU"
      ]
    }
  ],
  "total": 8748286736289853000
}

Example

Get first 4 matching names by prefix (forced 'thumbnail' view)

http https://api.nf.domains/nfd/v2/search?prefix=patric&view=thumbnail&limit=4

{
    "nfds": [
        {
            "appID": 1184583458,
            "depositAccount": "MQ2QJHZSZ6A7ZXPFE2EPIWLYUMRRDO3DQBEO6NIQ2B5A5OJ4VMWOOI2AX4",
            "name": "patrick.voi.algo",
            "owner": "MQ2QJHZSZ6A7ZXPFE2EPIWLYUMRRDO3DQBEO6NIQ2B5A5OJ4VMWOOI2AX4",
            "parentAppID": 984682143,
            "properties": {},
            "state": "owned"
        },
        {
            "appID": 1016975892,
            "depositAccount": "SAC732VSDG3J7ZVDOIV7I5Y3REVCYB2EPMNU6PRLJY67L37YOARYSD2PDM",
            "name": "patricia.eth.algo",
            "owner": "SAC732VSDG3J7ZVDOIV7I5Y3REVCYB2EPMNU6PRLJY67L37YOARYSD2PDM",
            "parentAppID": 1016578024,
            "properties": {},
            "state": "owned"
        },
        {
            "appID": 1016975648,
            "depositAccount": "SAC732VSDG3J7ZVDOIV7I5Y3REVCYB2EPMNU6PRLJY67L37YOARYSD2PDM",
            "name": "patricia.btc.algo",
            "owner": "SAC732VSDG3J7ZVDOIV7I5Y3REVCYB2EPMNU6PRLJY67L37YOARYSD2PDM",
            "parentAppID": 1016575127,
            "properties": {},
            "state": "owned"
        },
        {
            "appID": 1016602998,
            "depositAccount": "MQ2QJHZSZ6A7ZXPFE2EPIWLYUMRRDO3DQBEO6NIQ2B5A5OJ4VMWOOI2AX4",
            "name": "patrick.btc.algo",
            "owner": "MQ2QJHZSZ6A7ZXPFE2EPIWLYUMRRDO3DQBEO6NIQ2B5A5OJ4VMWOOI2AX4",
            "parentAppID": 1016575127,
            "properties": {},
            "state": "owned"
        }
    ],
    "total": 10
}

The thumbnail view will return verified and userDefined avatars for names. This way, the UI can show avatars with choices as well, as seen here in this NFDomains search UI example:

Note the verified.avatarasaid property in this example (same exists for banner, bannerasaid when fetching with other views). For integrations that manage their own ASA caching, this may make it easier to reference already cached versions of the NFT image if the ASA id is used instead of IPFS CID references.