Sign in

v26

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1247150179.9 KB
domain-registration

Register or transfer in a domain

Register a new domain or transfer an existing domain into your account. The request body specifies the domain name and optional DNS configuration including registration period, contacts, and nameserver settings.

To register a new domain, submit the request without an authorization code. To transfer in an existing domain from another registrar, include the dns.authorizationCode field — the presence of this field determines that this is a transfer-in rather than a new registration.

Use $preview=true to validate the request and get a price quote without executing the operation.

post/domains

Query parameters

$previewboolean required

Request body

namestring required

Fully qualified domain name to register (e.g., "example.com"). Automatically lowercased and trimmed.

Example request

{
  "owner": {
    "contact": {
      "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "phone": {
        "dialingPrefix": "+1"
      }
    }
  },
  "dns": {
    "contacts": {
      "admin": {
        "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "phone": {
          "dialingPrefix": "+1"
        }
      },
      "tech": {
        "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "phone": {
          "dialingPrefix": "+1"
        }
      },
      "billing": {
        "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "phone": {
          "dialingPrefix": "+1"
        }
      }
    },
    "nameservers": [
      "ns1.example.com",
      "ns2.example.com"
    ]
  }
}

Response

Domain registration operation created

@type'unstoppabledomains.com/partner.v3.DomainOperationResult' required

Example response

{
  "operation": {
    "id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "dependencies": [
      {
        "id": "plop_abc12345-1234-1234-1234-abc123456789",
        "parameters": {
          "owner": {
            "id": "con_abc12345-1234-1234-1234-abc123456789"
          },
          "contacts": {
            "admin": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            },
            "billing": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            },
            "tech": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            }
          },
          "period": 1
        }
      }
    ]
  }
}