Check subname availability

GET /v1/subname/availability

In order to find out whether a subname is available for minting, make a request to /subname/availability/{label}/{domain}:

• label is the label of requested the subname - for example ninja in ninja.thenamespace.eth

• domain is the full ENS name - for example thenamespace.eth

Refer to the Response Body section below for response details.

get

/v1/subname/availability/{label}//{domain}

Path parameters

labelstringrequired

Expected subname label

Example: ninja

domainstringrequired

Expected domain name of the subname

Example: thenamespace.eth

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/subname/availability/{label}/{domain}'

200

SubnameAvailabilityResponse

200

No body

Provides information whether the subname for the provided domain is available for minting. Refer to SubnameAvailabilityResponse