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

label*string

Expected subname label

Example: "ninja"

domain*string

Expected domain name of the subname

Example: "thenamespace.eth"

Response

200SubnameAvailabilityResponse

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

Request

JavaScriptCurlPython

const response = await fetch('/v1/subname/availability/{label}/{domain}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

SubnameAvailabilityResponse

{
  "isAvailable": false
}