Ens

Get all by ENS Domain

get

https://api.justaname.idhttps://api-staging.justaname.idhttp://localhost:8000

/ens/v1/subname/ens

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

get

/ens/v1/subname/ens

HTTPcURLJavaScriptPython

GET /ens/v1/subname/ens?ensDomain=text&chainId=1 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"
  }
}