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

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

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

Last updated