Reserve

Reserve Subname

Reserve Subname to be claimed later.

POSThttps://api.justaname.id/ens/v1/subname/reserve

Header parameters

Body

application/json

username*string

The username

Example: "ghadi"

ensDomain*string

The second-level domain

Example: "justan.id"

chainId*number

The chain id

Example: 1

ethAddress*string

The eth address to reserve the subdomain for

Example: "0xb965a5f3a0fC18D84E68883ccAd508445a7917A8"

Response

default

The Subname was reserved successfully.

Body

application/json

statusCode*number

The status code of the response.

Example: 200

result*SubnameReserveApiResponseResultSwagger (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.justaname.id/ens/v1/subname/reserve', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "username": "ghadi",
      "ensDomain": "justan.id",
      "chainId": 1,
      "ethAddress": "0xb965a5f3a0fC18D84E68883ccAd508445a7917A8"
    }),
});
const data = await response.json();

Response

default

{
  "statusCode": 200,
  "result": {
    "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"
        }
      }
    },
    "error": "text"
  }
}