Domain Registration Lifecycle: Registrar to WHOIS

You just registered a domain for a client, but it shows as pending in your dashboard. Or you're trying to transfer a domain and it won't budge. The domain registration lifecycle explains why: a domain moves through several systems before it becomes live, and each step has its own status codes. This walkthrough covers the entire process from registrar to registry to WHOIS, with a focus on EPP status codes and the pending states that confuse even experienced resellers.

What happens when you register a domain?

When you register a domain, your request goes through a registrar, which submits it to the registry for the top-level domain (TLD). The registry then creates the domain record and publishes it to the WHOIS database. This process is not instant; it involves several checks and can take minutes to hours. Understanding each step helps you diagnose why a domain might appear as pending.

Step 1: The registrar receives your order

You or your client submits a domain registration order through your platform. The registrar (which could be you, if you're a reseller using a white-label platform) validates the domain's availability by querying the registry. If the domain is available, the registrar proceeds to create a registration request. At this point, the domain is not yet registered; it's in a pre-registration state.

Step 2: The registry processes the request

The registry is the authoritative database for a specific TLD (like .com, .net, .org). It receives the registration request from the registrar and checks it against its own rules: Is the domain available? Does it meet syntax requirements? Are there any restrictions (e.g., for .gov or .edu)? If everything passes, the registry creates the domain record and returns a confirmation to the registrar. This is when the domain officially exists, but it may not be immediately visible in WHOIS.

Step 3: WHOIS database update

Once the registry creates the domain, it publishes the registration data to the WHOIS database. WHOIS is a public directory that shows the domain's registrar, creation date, expiration date, name servers, and status codes. However, the update is not always instantaneous. Registries often batch WHOIS updates, so there can be a delay of several minutes to a few hours before the domain appears in WHOIS queries. During this window, the domain might show as pending in your system.

Why does a new domain sometimes show as pending?

A new domain shows as pending because the registration process is not complete until the registry confirms the creation and the WHOIS database is updated. Several factors can cause this delay:

• Registry processing time: Some registries take longer to process new registrations, especially for certain TLDs.
• WHOIS propagation delay: As mentioned, WHOIS updates can be batched, causing a lag.
• Payment verification: If your payment method requires manual review, the registrar may hold the order until funds clear.
• Domain validation: Some TLDs require additional validation (e.g., .bank, .law) that can take days.
• EPP status codes: The domain might be in a pending state due to EPP status codes set by the registry or registrar.

In most cases, the pending status resolves on its own within a few hours. If it persists, check the EPP status codes for clues.

What are EPP status codes and what do they mean?

EPP (Extensible Provisioning Protocol) status codes are standardized labels that indicate the current state of a domain. They are set by the registry or registrar and can affect whether a domain can be modified, transferred, or deleted. Here are the most common EPP status codes and their meanings:

• ok: The domain is active and has no pending operations or prohibitions.
• inactive: The domain has no name servers associated with it. It won't resolve until name servers are set.
• clientHold: The registrar has put the domain on hold, usually due to non-payment or a dispute. The domain won't resolve.
• serverHold: The registry has put the domain on hold, often due to legal issues or invalid WHOIS data. The domain won't resolve.
• clientTransferProhibited: The registrar has locked the domain to prevent unauthorized transfers. This is common for newly registered domains (60-day lock).
• serverTransferProhibited: The registry has locked the domain to prevent transfers, often during a pending transfer or for legal reasons.
• pendingCreate: The domain creation is in progress. This is typical for new registrations.
• pendingTransfer: A transfer request has been submitted and is awaiting approval.
• pendingDelete: The domain is scheduled for deletion and will soon be available for registration.
• pendingRenew: The domain renewal is in progress.
• pendingUpdate: An update to the domain (e.g., name server change) is in progress.

When you see a domain with a status like pendingCreate, it means the registration is still being processed. Once the registry completes the creation, the status should change to ok or inactive (if no name servers are set).

How to check EPP status codes and WHOIS data

You can check a domain's EPP status codes by performing a WHOIS lookup. Most registrars and third-party tools (like whois.icann.org) provide this information. Look for the "Domain Status" field in the WHOIS output. If you're a reseller, your platform may have a built-in WHOIS tool or API that shows these codes. For example, Teculiar, a platform for hosting and domain resellers, includes domain management tools that display status codes and allow you to automate provisioning. You can also use the public API to query domain status programmatically.

If you see a status like clientHold, contact your registrar to resolve the issue. For pendingCreate, wait a few hours and check again. If the status persists beyond 24 hours, open a support ticket with your registrar.

Step-by-step: From registration to active domain

Here's a recap of the lifecycle with typical timings:

• Order submission: Instant. Your registrar receives the order.
• Registry processing: Usually seconds to minutes. The registry creates the domain record.
• WHOIS update: Minutes to hours. The domain appears in WHOIS with status pendingCreate or ok.
• Name server configuration: If you set name servers, the domain becomes active and resolves. This can take up to 48 hours for DNS propagation, but the domain status changes to ok once name servers are set.
• Transfer lock: Newly registered domains are often locked for 60 days (clientTransferProhibited) to prevent transfers.

If you're using a reseller platform, the provisioning process may automate name server assignment and DNS management. For example, Teculiar's automation can handle domain registration and DNS setup, reducing manual steps. Check the pricing page for details on domain reseller features.

Common issues and how to resolve them

Here are typical problems resellers face and their solutions:

• Domain stuck in pendingCreate: Wait up to 24 hours. If still pending, contact your registrar. It could be a registry issue or payment hold.
• Domain shows clientHold: Check for unpaid invoices or WHOIS data verification. Update payment or verify email.
• Transfer fails due to clientTransferProhibited: Unlock the domain at the current registrar and obtain the authorization (EPP) code. Then initiate transfer.
• WHOIS shows incorrect information: Update the domain's contact details through your registrar. Some TLDs require verification; failure to verify can lead to serverHold.

Understanding EPP status codes helps you diagnose these issues quickly. For a deeper dive into domain management, see our blog.

What to do next

• Check the EPP status of any pending domains in your account using a WHOIS lookup.
• Ensure your payment method is valid to avoid clientHold due to non-payment.
• Verify your WHOIS contact email to prevent serverHold from unverified data.
• If you're a reseller, consider a platform that automates domain provisioning and status monitoring to reduce manual checks.

Review your domain management workflow and update your processes to handle pending states efficiently.