JustaName
API ReferenceSDK Reference
API Reference
API Reference
  • Overview
  • API reference
    • Siwe
      • Request challenge
      • Verify message
      • Mapp
        • Add permission
        • Append field
        • Revoke permission
    • Subname
      • Accept
      • Reserve
      • Add
      • Update
      • Revoke
      • Reject
      • Subname
      • Ens
      • Address
      • Records
      • Available
      • Search
      • Ens list
    • Primary name
      • Address
      • Set primary name
  • Specification
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. API reference
  2. Subname

Ens

PreviousSubnameNextAddress

Was this helpful?

Get all by ENS Domain

get

Retrieves all subnames associated with the provided ens domain

Query parameters
ensDomainstringRequired

The ENS domain

Example: justan.id
chainIdnumberRequired

Chain id, we only support Ethereum Mainnet and Sepolia Testnet (1 for mainnet, 11155111 for sepolia)

Example: 1
pagenumberOptional

The page number (defaults to 1)

Example: 1
limitnumberOptional

The number of items per page (defaults to 20)

Example: 20
isClaimedbooleanOptional

if true, will return claimed subdomain, if false, will return unclaimed subdomain, if not provided, will return all subdomains

Example: true
Responses
200
Subnames were fetched successfully.
application/json
Responseall of
get
GET /ens/v1/subname/ens HTTP/1.1
Host: api.justaname.id
Accept: */*
200

Subnames were fetched successfully.

{
  "statusCode": 200,
  "result": {
    "data": {
      "data": [
        {
          "ens": "user.justan.id",
          "isClaimed": true,
          "claimedAt": "2024-05-22T11:55:29.000Z",
          "isJAN": true,
          "records": {
            "resolverAddress": "0x48De002d3c64e4cFD130A87A35ECD960c01954bc",
            "texts": [
              {
                "key": "com.twitter",
                "value": "justaname_id"
              }
            ],
            "coins": [
              {
                "id": 60,
                "name": "eth",
                "value": "0x1FA89227d0F42960eb5f5693fAFCF58e255A4dfa"
              }
            ],
            "contentHash": {
              "protocolType": "ipfs",
              "decoded": "bafybeiafwq5iqeyk73or3dmzyjyqaauyzdwi3xtync7h6kp64umwvsiumi"
            }
          }
        }
      ],
      "pagination": {
        "totalCount": 20,
        "page": 1,
        "limit": 10,
        "totalPages": 2,
        "nextPage": 2,
        "prevPage": null,
        "hasNextPage": true,
        "hasPrevPage": false
      }
    },
    "error": "text"
  }
}