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

x-api-key<token>

In: header

Header Parameters

x-namefi-eip7702-account?string

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-account?string

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-account?string

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

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 "https://api.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",
        "domainSetupOptions": {
          "autoPark": true,
          "autoEns": true,
          "autoRenew": true,
          "dnssec": true,
          "keepExistingNameservers": true
        },
        "tldRegistrationRequirementAcknowledged": true,
        "mintTransaction": {
          "txHash": "string",
          "recordedAt": "string"
        },
        "extendTransaction": {
          "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": "PAYMENT_REQUIRED",
  "status": 402,
  "message": "Payment Required",
  "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 With X402 GET

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

Get outbound run status GET

Get the current status and aggregate counts for one outbound lead-finding run. Poll using pollAfterSeconds while status is QUEUED or RUNNING.