Domain management concepts

Overview

This page explains the concepts behind domain registration and management — what registrars, registries, DNS, and the domain lifecycle mean at a technical level. Understanding these concepts makes the API's behavior more predictable and helps you build integrations that handle edge cases correctly.

Domain registration

A domain name is a human-readable address registered in a global distributed database. When you register a domain, you're leasing the right to use that name for a fixed period (typically 1–10 years) from the registry [the organization that manages a top-level domain (TLD)].

Registrars and registries

Two distinct organizations are involved in every domain registration:

GoDaddy is an ICANN-accredited registrar. When you register a domain through the GoDaddy API, GoDaddy submits the registration to the appropriate registry on your behalf. The registry is the source of truth. A domain doesn't exist until the registry acknowledges it.

What you own

When you register a domain, you don't own it in the traditional sense. You hold the right to use it for the registration period. The registry can reclaim domains that violate its policies (for example, trademark disputes decided by ICANN's UDRP process).

Registration creates a record in the registry's WHOIS database associating the domain with a registrant contact. The registrant contact is the legal owner for the duration of the registration.

The domain lifecycle

Domains pass through defined states from registration to expiration and beyond.

Grace periods

After expiration, GoDaddy provides a recovery window before the domain is permanently released. The exact timing varies by TLD, but the general pattern for gTLDs is:

• 0–12 days after expiration: Standard renewal pricing applies. The domain is still in your account.
• 12–42 days after expiration: Redemption period. The domain can be recovered but with additional fees. It's no longer visible in your account.
• After redemption period: The domain is released back to the registry and becomes available for registration by anyone.

ccTLDs (country-code TLDs like .uk, .de, .ca) have significantly different timelines — some expire immediately with no grace period. Always verify the TLD's expiration policy before building automated renewal logic.

DNS and nameservers

DNS (Domain Name System) translates domain names into IP addresses (and other resource records). It's a distributed hierarchical system — no single server knows everything.

Authoritative nameservers

Every domain has authoritative nameservers (the servers that hold the definitive DNS records for that domain). When a resolver looks up example.com, it eventually reaches example.com's authoritative nameservers and gets the answer directly from them.

At registration, GoDaddy assigns its own authoritative nameservers to your domain by default. While GoDaddy's nameservers are authoritative, you manage DNS records through the GoDaddy API (/v3/domains/zones/{zone}/dns-records).

If you want to use a different DNS provider (like Cloudflare or Route 53.), you delegate authority by replacing the nameservers with that provider's servers (PUT /v3/domains/domain-names/{domain-name}/nameservers). After delegation, GoDaddy's API can no longer manage DNS records for the domain and the other provider's tools apply.

DNS record types

The following table lists the different DNS record types.

DNS propagation

When you change a DNS record, the new value doesn't appear instantly everywhere. DNS changes propagate through a cache hierarchy. Each record has a TTL (time-to-live) value that controls how long resolvers cache it before checking for updates.

With GoDaddy's authoritative DNS:

• Changes applied through the v3 API take effect synchronously on GoDaddy's nameservers.
• Cached copies elsewhere on the internet expire at the rate set by the record's TTL (minimum 600 seconds, maximum 86400 seconds on GoDaddy's v3 API).
• Resolvers that haven't cached the old value will see the new one immediately.

Propagation delay means there's a window after a DNS change where different users see different values depending on which resolver they use. For this reason, DNS changes for critical infrastructure (mail routing, SSL validation) should be planned and staged and not made under pressure.

WHOIS and contact privacy

WHOIS is a protocol for querying the registry's public contact database. It exposes the registrant name, email, phone, and mailing address for every registered domain unless privacy protection is enabled.

Contact roles

Every domain registration requires a registrant contact. Some registrations can require up to four contact roles. The following table lists the contact roles and their purposes:

ICANN requires registrant contact information to be accurate. Providing false information can result in domain suspension. Use WHOIS privacy if you want to mask your contact details from the public database. Privacy services replace the real contact information with the privacy service's placeholder data in the WHOIS record.

Domain locking

Registry lock (the clientTransferProhibited status flag) is a security feature that prevents other registrars from initiating a transfer out of GoDaddy without your explicit action. While locked, the registry will reject transfer requests from competing registrars.

Lock is enabled by default at registration. It has no effect on DNS resolution, email delivery, SSL certificates, or any service hosted on the domain. It should only be disabled for the duration of an outbound transfer or a registrant change on TLDs that require it, and re-enabled immediately after.

Go to Lock a domain for the API operations to read and toggle the lock state.

Last updated on