Get An Account's Subdomains

This endpoint returns you subdomains that are owned by the given account hash

Parameters

  • hash- The subdomain owner's account hash to query for

Results

Valid Response

<object>- a JSON object containing the following fields:

  • owner:<String>, the subdomain owner's account hash
  • subdomains:[<object>], a list of subdomains owned by an account which contains the following fields each:
    • name:<String>, the name of the subdomain
    • subdomainHash:<String>, the account hash for the subdomain

Example of a valid response:

{
  "status": "Success",
  "message": "Retrieved Account's Sub Domains",
  "result": {
    "owner": "AWtw4WVrDpyQEf1e8upxh47Aot5pECtAppeAWiajK6nW",
    "subdomains": [
      {
        "name": "scams",
        "subdomainHash": "2Tkx4fck2MqRWiWmdZdnP97iTHcByU4934hQbkNhKUkd"
      },
      {
        "name": "tokens",
        "subdomainHash": "4fsGxgYqboEppzz2gPPvDSJKwzy8w7kz7Gdfqpumd6Zf"
      },
      {
        "name": "rugs",
        "subdomainHash": "B3LgYWC8VcnAdCEy86owzoS5LLahVR9ffKBXEXe2sPFU"
      },
      {
        "name": "earners",
        "subdomainHash": "TMn55Tvssy5U2poEkSAthfhJaBSqwqcS5eg1B6G3oYT"
      },
      {
        "name": "bank",
        "subdomainHash": "2TprTY5h6j3bPyN4TuMnNBMAveufGBPFBvZY2dCCwuJ4"
      },
      {
        "name": "nfts",
        "subdomainHash": "FaAJVhs1tCYNWZUVMSi72ps6Wpy8YqpnQwWz9xwVXuiK"
      },
      {
        "name": "nft",
        "subdomainHash": "4YKiL2rXiDFp4cwcKAp19uTvtsmLSbBYGrJ8Fu2KfCqv"
      },
      {
        "name": "forty",
        "subdomainHash": "5UF5R5J2gMEYXdG5cgP1ZGowM2EUgY5nCv8JAd8ftrT2"
      }
    ]
  }
}

Invalid Response

<object> - a JSON object containing the following fields if the requested account doesn't exist

  • code:<integer>, The error code
  • message:<String>, An error message to indicate which part of the query went wrong
  • status:<String>, The response status following the error code
    • 400 = Bad Request (client side)
    • 500 = Internal Server Error (server side)
Language
Click Try It! to start a request and see the response here!