Skip to content
Reseller API
/
/Registration & Renewals

Reseller API (1.0.0)

Feature Overview

The Reseller API provides domain reseller partners with the ability to search, register and manage traditional DNS domains. The API exposes a RESTful interface for domain registration, DNS management, and domain lifecycle operations.

  • Domain Discovery: Search for specific domains or find suggested alternatives, determine pricing, availability and registration details
  • Domain Registration: Register domains with full control over registration period, contacts, and initial DNS configuration
  • DNS Management: Create, update and delete DNS records for your domains
  • Domain Lifecycle: Manage renewals, transfers, contacts, and domain flags through a simple API interface

For access, authentication, environments, and your first request, start with the Quick Start.

For implementation guidance on operations, flags, registration flows, contact management, DNS management, webhooks, and lifecycle operations, see the Implementation Guide.

Overview
Unstoppable Domains (Reseller Engineering)
partnerengineering@unstoppabledomains.com
Languages
Servers
Production
https://api.unstoppabledomains.com/partner/v3
Sandbox
https://api.ud-sandbox.com/partner/v3

Suggestions

Find available domain alternatives based on keywords and preferences.

Operations

Registration & Renewals

Register new domains and manage renewals. Use $preview=true to validate requests and get price quotes before committing.

Operations

Register or transfer in a domain

Request

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.

Security
bearer
Query
$previewbooleanrequired
Default false
Bodyapplication/jsonrequired
namestringrequired

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

ownerobject(DomainRegistrationRequestBodyOwner)

Domain owner configuration. For reseller registrations, type must be SELF. The contact field specifies the registrant — provide either an existing contact ID or inline contact fields.

dnsobject(DomainRegistrationRequestBodyDns)

DNS configuration for the domain including registration period and contact role assignments.

flagsobject(DomainFlagUpdateRequestBody)

Update domain flag settings. Only include the flags you want to change — omitted flags remain unchanged.

curl -i -X POST \
  'https://api.unstoppabledomains.com/partner/v3/domains?%24preview=false' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "owner": {
      "type": "SELF",
      "contact": {
        "tldData": {
          "ca": {
            "registrantAgreementAcknowledged": true,
            "preferredLanguageCode": "en_US",
            "canadianPresenceRequirement": "CCT"
          }
        },
        "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "firstName": "string",
        "lastName": "string",
        "organization": "string",
        "countryCode": "string",
        "street": "string",
        "city": "string",
        "postalCode": "string",
        "stateProvince": "string",
        "phone": {
          "number": "string",
          "dialingPrefix": "+1"
        },
        "email": "user@example.com"
      }
    },
    "dns": {
      "authorizationCode": "string",
      "period": 1,
      "contacts": {
        "admin": {
          "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "firstName": "string",
          "lastName": "string",
          "organization": "string",
          "countryCode": "string",
          "street": "string",
          "city": "string",
          "postalCode": "string",
          "stateProvince": "string",
          "phone": {
            "number": "string",
            "dialingPrefix": "+1"
          },
          "email": "user@example.com"
        },
        "tech": {
          "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "firstName": "string",
          "lastName": "string",
          "organization": "string",
          "countryCode": "string",
          "street": "string",
          "city": "string",
          "postalCode": "string",
          "stateProvince": "string",
          "phone": {
            "number": "string",
            "dialingPrefix": "+1"
          },
          "email": "user@example.com"
        },
        "billing": {
          "id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "firstName": "string",
          "lastName": "string",
          "organization": "string",
          "countryCode": "string",
          "street": "string",
          "city": "string",
          "postalCode": "string",
          "stateProvince": "string",
          "phone": {
            "number": "string",
            "dialingPrefix": "+1"
          },
          "email": "user@example.com"
        }
      },
      "$useExistingNameservers": true,
      "nameservers": [
        "ns1.example.com",
        "ns2.example.com"
      ],
      "records": [
        {
          "subName": "string",
          "type": "A",
          "values": [
            "string"
          ],
          "ttl": 1,
          "$upsert": "REPLACE",
          "$forceCompatibility": false
        }
      ],
      "dnssec": {
        "items": [
          {
            "keyTag": 65535,
            "algorithm": 1,
            "digestType": 1,
            "digest": "string"
          }
        ]
      }
    },
    "flags": {
      "DNS_RESOLUTION": {
        "status": "ENABLED"
      },
      "DNS_TRANSFER_OUT": {
        "status": "ENABLED"
      },
      "DNS_DELETE": {
        "status": "ENABLED"
      },
      "DNS_UPDATE": {
        "status": "ENABLED"
      },
      "DNS_RENEW": {
        "status": "ENABLED"
      },
      "DNS_WHOIS_PROXY": {
        "status": "ENABLED"
      }
    }
  }'

Responses

Domain registration operation created

Bodyapplication/json
@typestringrequired
Value"unstoppabledomains.com/partner.v3.DomainOperationResult"
operationobject(OperationCheckResponse)required
operation.​@typestringrequired
Value"unstoppabledomains.com/partner.v3.Operation"
operation.​idstring^op-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a...required

Operation ID

Example: "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
operation.​statusstringrequired
Enum"PREVIEW""QUEUED""PROCESSING""FAILED""COMPLETED""CANCELLED""AWAITING_UPDATES"
operation.​typestringrequired
Enum"ADMIN_GENERIC""DOMAIN_ADMIN_UPDATE""DOMAIN_RENEW""ACCOUNT_UPDATE""DOMAIN_DNS_RECORD_CREATE""DOMAIN_DNS_RECORD_UPDATE""DOMAIN_DNS_RECORD_DELETE""DOMAIN_DNS_RECORD_BATCH""DOMAIN_DNS_SECURITY_ENABLE""DOMAIN_DNS_SECURITY_DELETE"
operation.​domainstring
operation.​createdAtTimestampnumberrequired
operation.​lastUpdatedTimestampnumberrequired
operation.​validUntilTimestampnumber
operation.​dependenciesArray of any(PlatformOperationDependency)required

List of platform operation dependencies that make up this operation

operation.​dependencies[].​idstringrequired
Example: "plop_abc12345-1234-1234-1234-abc123456789"
operation.​dependencies[].​@typestringrequired
Value"unstoppabledomains.com/partner.v3.PlatformOperation"
operation.​dependencies[].​statusstring(PlatformOperationStatus)required

Status of a platform operation dependency

Enum"PREVIEW""QUEUED""PROCESSING""FAILED""COMPLETED""CANCELLED""AWAITING_UPDATES"
operation.​dependencies[].​typestringrequired
Value"DOMAIN_REGISTER"
Discriminator
operation.​dependencies[].​parametersobjectrequired
operation.​dependencies[].​parameters.​ownerobject(ContactAssignment)required

Reference to an existing or newly created contact

operation.​dependencies[].​parameters.​owner.​newbooleanrequired

Whether this contact is being newly created as part of this operation

operation.​dependencies[].​parameters.​owner.​idstring

Contact ID (present when new is false)

Example: "con_abc12345-1234-1234-1234-abc123456789"
operation.​dependencies[].​parameters.​contactsobject(NonRegistrantContacts)

Non-registrant contact role assignments (admin, billing, tech)

operation.​dependencies[].​parameters.​periodinteger

Registration period in years

Example: 1
operation.​dependencies[].​errorobject(OperationDependencyError)

Error details for a failed operation dependency

Response
application/json
{
  "@type": "unstoppabledomains.com/partner.v3.DomainOperationResult",
  "operation": {
    "@type": "unstoppabledomains.com/partner.v3.Operation",
    "id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PREVIEW",
    "type": "ADMIN_GENERIC",
    "domain": "string",
    "createdAtTimestamp": 0,
    "lastUpdatedTimestamp": 0,
    "validUntilTimestamp": 0,
    "dependencies": [ … ]
  }
}

Get domain renewal info

Request

Retrieve renewal eligibility and pricing for the specified domain, including the current expiration date, grace period expiration, and available renewal periods.

Security
bearer
Path
namestringrequired
curl -i -X GET \
  'https://api.unstoppabledomains.com/partner/v3/domains/{name}/renewals' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Domain renewal pricing and eligibility

Bodyapplication/json
@typestringrequired
Value"unstoppabledomains.com/partner.v3.DomainRenewalInfo"
isEligiblebooleanrequired
expirationDatestringrequired
gracePeriodExpirationDatestring
priceobject(DomainPriceResponse)
periodobject(IcannDomainRenewalInfoPeriodResponse)required
period.​minnumberrequired
period.​maxnumberrequired
period.​incrementsnumberrequired
Response
application/json
{
  "@type": "unstoppabledomains.com/partner.v3.DomainRenewalInfo",
  "isEligible": true,
  "expirationDate": "string",
  "gracePeriodExpirationDate": "string",
  "price": {
    "type": "STANDARD",
    "listPrice": { … },
    "adjustments": [ … ],
    "subTotal": { … },
    "validUntilTimestamp": 0
  },
  "period": {
    "min": 0,
    "max": 0,
    "increments": 0
  }
}

Renew a domain

Request

Renew the specified domain for a given period (in years). Use $preview=true to get a renewal price quote without executing the renewal.

Security
bearer
Path
namestringrequired
Query
$previewbooleanrequired
Default false
Bodyapplication/jsonrequired
periodnumber[ 1 .. 10 ]required

Renewal period in years (1-10).

curl -i -X POST \
  'https://api.unstoppabledomains.com/partner/v3/domains/{name}/renewals?%24preview=false' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "period": 1
  }'

Responses

Domain renewal operation created

Bodyapplication/json
@typestringrequired
Value"unstoppabledomains.com/partner.v3.DomainOperationResult"
operationobject(OperationCheckResponse)required
operation.​@typestringrequired
Value"unstoppabledomains.com/partner.v3.Operation"
operation.​idstring^op-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a...required

Operation ID

Example: "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
operation.​statusstringrequired
Enum"PREVIEW""QUEUED""PROCESSING""FAILED""COMPLETED""CANCELLED""AWAITING_UPDATES"
operation.​typestringrequired
Enum"ADMIN_GENERIC""DOMAIN_ADMIN_UPDATE""DOMAIN_RENEW""ACCOUNT_UPDATE""DOMAIN_DNS_RECORD_CREATE""DOMAIN_DNS_RECORD_UPDATE""DOMAIN_DNS_RECORD_DELETE""DOMAIN_DNS_RECORD_BATCH""DOMAIN_DNS_SECURITY_ENABLE""DOMAIN_DNS_SECURITY_DELETE"
operation.​domainstring
operation.​createdAtTimestampnumberrequired
operation.​lastUpdatedTimestampnumberrequired
operation.​validUntilTimestampnumber
operation.​dependenciesArray of any(PlatformOperationDependency)required

List of platform operation dependencies that make up this operation

operation.​dependencies[].​idstringrequired
Example: "plop_abc12345-1234-1234-1234-abc123456789"
operation.​dependencies[].​@typestringrequired
Value"unstoppabledomains.com/partner.v3.PlatformOperation"
operation.​dependencies[].​statusstring(PlatformOperationStatus)required

Status of a platform operation dependency

Enum"PREVIEW""QUEUED""PROCESSING""FAILED""COMPLETED""CANCELLED""AWAITING_UPDATES"
operation.​dependencies[].​typestringrequired
Value"DOMAIN_REGISTER"
Discriminator
operation.​dependencies[].​parametersobjectrequired
operation.​dependencies[].​parameters.​ownerobject(ContactAssignment)required

Reference to an existing or newly created contact

operation.​dependencies[].​parameters.​owner.​newbooleanrequired

Whether this contact is being newly created as part of this operation

operation.​dependencies[].​parameters.​owner.​idstring

Contact ID (present when new is false)

Example: "con_abc12345-1234-1234-1234-abc123456789"
operation.​dependencies[].​parameters.​contactsobject(NonRegistrantContacts)

Non-registrant contact role assignments (admin, billing, tech)

operation.​dependencies[].​parameters.​periodinteger

Registration period in years

Example: 1
operation.​dependencies[].​errorobject(OperationDependencyError)

Error details for a failed operation dependency

Response
application/json
{
  "@type": "unstoppabledomains.com/partner.v3.DomainOperationResult",
  "operation": {
    "@type": "unstoppabledomains.com/partner.v3.Operation",
    "id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PREVIEW",
    "type": "ADMIN_GENERIC",
    "domain": "string",
    "createdAtTimestamp": 0,
    "lastUpdatedTimestamp": 0,
    "validUntilTimestamp": 0,
    "dependencies": [ … ]
  }
}

Domain Management

Comprehensive domain updates — modify nameservers, DNSSEC, contacts, flags, and DNS records in a single request.

Operations

DNS Records

Create, read, update and delete DNS records for your domains. Also includes DNS metadata, nameserver management, and DNSSEC configuration.

Operations

Transfers

Check transfer eligibility and retrieve authorization codes for transferring domains to another registrar.

Operations

Domain Flags

View and manage domain flags that control behavior and security settings such as DNS resolution, transfer locks, WHOIS privacy, and more.

Operations

Domain Contacts

View and update the ICANN-required contacts (owner, admin, tech, billing) assigned to a specific domain.

Operations

Pricing

Retrieve pricing information for domain registration, renewal, transfer, and restoration by domain name or TLD.

Operations

TLDs

Browse available top-level domains (TLDs), their details, and DNS security configuration.

Operations

Contacts

Create and manage ICANN-required contacts for domain registration. Contacts represent individuals or organizations associated with domain roles (owner, admin, tech, billing).

New contacts are automatically sent a verification email upon creation. Contacts can be used in domain registrations immediately, but domains associated with unverified contacts may become unmanageable after a certain period.

Operations

Operations

All asynchronous processes handled by the API are represented as Operations. This includes registering a domain, updating DNS records, renewing a domain, and more.

Operations contain dependencies that represent the individual units of work. Each dependency has its own status, parameters, and result data.

Operations
Webhooks

Hosting

Configure how your domains serve content on the web. Hosting configurations control what happens when someone visits your domain — whether it redirects to another URL or proxies content from another server.

Available hosting types:

  • REDIRECT_301 — Permanent redirect to another URL
  • REDIRECT_302 — Temporary redirect to another URL
  • REVERSE_PROXY — Proxy requests to a backend server

All hosting configurations require SSL certificate provisioning. When a configuration is created or updated, the certificateStatus field will be PENDING until the certificate is issued and active. This process typically completes within a few minutes but may take longer in some cases.

Operations

Account

Manage your account details, authentication tokens, and webhook subscriptions.

Operations