logo
OpenapiOrders

Instant register domain with records

API Docs with browser client
POST
/orders/register-domain/records

Purchase a single domain instantly and apply DNS records after processing.

Authorization

AuthorizationBearer <token>

In: header

Request Body

application/json

normalizedDomainName*string
Match^[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?(\.[a-z0-9_]([a-z0-9-]{0,61}[a-z0-9_])?)*$
durationInYears?integer
Default1
Range1 <= value <= 10
records?
Default[]
nftReceivinggWallet?

Wallet address and chain ID of the wallet that will receive the NFT, defaults to the buyer's wallet and "Base Chain"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "http://backend.astra.namefi.dev/v-next/orders/register-domain/records" \  -H "Content-Type: application/json" \  -d '{    "normalizedDomainName": "string"  }'
{
  "id": "string",
  "userId": "string",
  "amountInUSDCents": 0,
  "nftWalletAddress": "string",
  "nftChainId": 0,
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
      "normalizedDomainName": "string",
      "amountInUSDCents": -2147483648,
      "durationInYears": -2147483648,
      "type": "REGISTER",
      "registrar": "string",
      "encryptionKeyId": "string",
      "encryptedEppAuthorizationCode": "string",
      "status": "CREATED",
      "metadata": {
        "freeClaim": true,
        "groupOrCampaignKey": "string",
        "claimId": "string",
        "mintTransaction": {
          "txHash": "string",
          "recordedAt": "string"
        },
        "postProcessOrderItem": {
          "actions": [
            {
              "scope": "dns-records",
              "action": "add",
              "records": [
                {
                  "name": "string",
                  "type": "A",
                  "rdata": "string",
                  "ttl": 2147483647
                }
              ]
            }
          ],
          "property1": null,
          "property2": null
        },
        "requiredAction": "EPP_UNLOCK_REQUIRED",
        "failureDetails": {
          "requiredAction": "EPP_UNLOCK_REQUIRED",
          "resolution": "USER_SIGNAL",
          "actor": "USER",
          "actorId": "string",
          "timeoutMs": -9007199254740991,
          "recordedAt": "string"
        },
        "backfilled_started_finished_at": true,
        "legacyOrderItemMetadata": {
          "source": "legacy",
          "type": "legacy-migration",
          "legacyItemId": "string",
          "chainId": 1,
          "receivingWalletAddress": "string"
        },
        "property1": null,
        "property2": null
      },
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "startedAt": "2019-08-24T14:15:22Z",
      "finishedAt": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "defined": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "Bad Request",
  "data": null
}
{
  "defined": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Unauthorized",
  "data": null
}
{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "Forbidden",
  "data": null
}
{
  "defined": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Not Found",
  "data": null
}
{
  "defined": true,
  "code": "NOT_ACCEPTABLE",
  "status": 406,
  "message": "Not Acceptable",
  "data": null
}
{
  "defined": true,
  "code": "TIMEOUT",
  "status": 408,
  "message": "Request Timeout",
  "data": null
}
{
  "defined": true,
  "code": "CONFLICT",
  "status": 409,
  "message": "Conflict",
  "data": null
}
{
  "defined": true,
  "code": "PRECONDITION_FAILED",
  "status": 412,
  "message": "Precondition Failed",
  "data": null
}
{
  "defined": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "Too Many Requests",
  "data": null
}
{
  "defined": true,
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal Server Error",
  "data": null
}

Instant Register domain POST

Purchase a single domain instantly without adding to cart. Validates domain availability, creates payments and order, then starts the order processing workflow.

Check domain availability GET

Check if a domain is available for registration. Returns availability status, pricing details, current owner (if any), and registration constraints.