Available

Was this helpful?

Checks if a username is available for a given ENS domain

get

/ens/v1/subname/available

Query parameters

subnamestringrequired

The subname

Example: user.justan.id

chainIdnumberrequired

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

Example: 1

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.justaname.id/ens/v1/subname/available?subname=text&chainId=1'

200

{
  "statusCode": 200,
  "result": {
    "data": {
      "isAvailable": false
    },
    "error": "text"
  }
}

Subname was fetched successfully.