JustaName
API ReferenceSDK Reference
API Reference
API Reference
  • Overview
  • API reference
    • Siwe
      • Request challenge
      • Verify message
      • Mapp
        • Add permission
        • Append field
        • Revoke permission
    • Subname
      • Accept
      • Reserve
      • Add
      • Update
      • Revoke
      • Reject
      • Subname
      • Ens
      • Address
      • Records
      • Available
      • Search
      • Ens list
    • Primary name
      • Address
      • Set primary name
  • Specification
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. API reference
  2. Subname

Reserve

PreviousAcceptNextAdd

Was this helpful?

Reserve Subname

post

Reserve Subname to be claimed later.

Header parameters
x-api-keystringRequired

The Api Key.

Body
usernamestringRequired

The username

Example: ghadi
ensDomainstringRequired

The second-level domain

Example: justan.id
chainIdnumberRequired

The chain id

Example: 1
ethAddressstringRequired

The eth address to reserve the subdomain for

Example: 0xb965a5f3a0fC18D84E68883ccAd508445a7917A8
Responses
default
The Subname was reserved successfully.
application/json
post
POST /ens/v1/subname/reserve HTTP/1.1
Host: api.justaname.id
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "username": "ghadi",
  "ensDomain": "justan.id",
  "chainId": 1,
  "ethAddress": "0xb965a5f3a0fC18D84E68883ccAd508445a7917A8"
}
default

The Subname was reserved successfully.

{
  "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"
  }
}