Get Domain/Subdomains Owned By An Account

This endpoint retrieves all domains and subdomains owned by the provided account hash

Parameters

  • hash- the account hash that owns domain(s)/subdomain(s)

Results

Valid Response

[<object>]- a list of JSON objects that contains the following fields each:

  • owner:<String>, the owner's account hash of the domain/subdomain
  • domains:[<object>], a list of domain objects that are owned by the queried account
    • name:<String>, the name of the domain account
    • nameServiceAccount:<String>, the account hash of the domain
    • subdomains:[<object>], a list of subdomains owned

Example of a valid response:

{
  "status": "Success",
  "message": "Retrieved Account's Domains",
  "result": [
    {
      "owner": "nix9RErnQYXpuf329ntPgSzThogtfeyUempD7zDrnSH",
      "domains": [
        {
          "name": "nixholas",
          "nameServiceAccount": "3krJN4n3cWZktUBbpm5KjdhHSEMfgvzSPLsKeeC9o2Xh",
          "subdomains": []
        }
      ]
    }
  ]
}

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!