domains

name	domains
requires_mcps	["hostinger-api"]
description	Use when user says "Hostinger domain", "buy domain", or "domain settings". Registration, nameservers, ownership, renewal.
last_updated	2026-03-20
doc_source	https://developers.hostinger.com

Hostinger Domains

The Domains API provides full domain lifecycle management — from checking availability and purchasing to configuring nameservers, forwarding, WHOIS profiles, domain locks, and privacy protection.

Tool surface — prefer MCP

This skill is paired with the hostinger-api MCP (@hostinger/api-mcp-server). Prefer mcp__hostinger-api__domains_* tools over raw curl. The curl examples below are the fallback path for debugging or when the MCP is unreachable — they are not the primary interface.

Available domain tools:

• domains_checkDomainAvailabilityV1 — pre-purchase availability + alternative TLD suggestions
• domains_getDomainListV1, domains_getDomainDetailsV1 — list and inspect portfolio
• domains_purchaseNewDomainV1 — buy a new domain (uses a WHOIS profile)
• domains_updateDomainNameserversV1 — change nameservers
• domains_getDomainForwardingV1, domains_createDomainForwardingV1, domains_deleteDomainForwardingV1 — 301/302 redirect CRUD
• domains_enableDomainLockV1, domains_disableDomainLockV1 — transfer-lock toggle
• domains_enablePrivacyProtectionV1, domains_disablePrivacyProtectionV1 — WHOIS privacy toggle
• domains_getWHOISProfileListV1, domains_getWHOISProfileV1, domains_createWHOISProfileV1, domains_deleteWHOISProfileV1, domains_getWHOISProfileUsageV1 — WHOIS profile CRUD + usage

Table of Contents

• Core Concepts
• Common Patterns
• API Reference
• Best Practices
• Troubleshooting
• References

Core Concepts

Domain Portfolio

Your domain portfolio contains all domains registered under your Hostinger account. Each domain has configuration for nameservers, WHOIS contacts, lock status, and privacy protection.

Domain Availability

Before purchasing, check if a domain name is available across one or more TLDs. The API also supports alternative domain suggestions.

Domain Forwarding

Redirect a domain to another URL using 301 (permanent) or 302 (temporary) redirects.

WHOIS Profiles

Contact information associated with domain registrations. Each TLD may require specific WHOIS details. Profiles can be reused across multiple domains.

Domain Lock

Prevents unauthorized domain transfers. Must be disabled before transferring a domain to another registrar.

Privacy Protection

Hides the domain owner's personal information from public WHOIS databases.

Common Patterns

Check Domain Availability

curl -X POST "https://developers.hostinger.com/api/domains/v1/availability" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "myawesomesite",
    "tlds": ["com", "net", "org"],
    "with_alternatives": true
  }'

Python SDK:

from hostinger_api import Hostinger

client = Hostinger(api_token="YOUR_API_TOKEN")
result = client.domains.availability.check(
    domain="myawesomesite",
    tlds=["com", "net", "org"],
    with_alternatives=True
)

TypeScript SDK:

import { Hostinger } from "hostinger-api-sdk";

const client = new Hostinger({ apiToken: "YOUR_API_TOKEN" });

const result = await client.domains.availability.check({
  domain: "myawesomesite",
  tlds: ["com", "net", "org"],
  withAlternatives: true,
});

PHP SDK:

use Hostinger\Api\HostingerApi;

$client = new HostingerApi('YOUR_API_TOKEN');

$result = $client->domains->availability->check([
    'domain' => 'myawesomesite',
    'tlds' => ['com', 'net', 'org'],
    'with_alternatives' => true,
]);

Note: Rate limited to 10 requests per minute. TLDs should be without leading dot (e.g., com not .com). For alternatives, provide only one TLD.

Purchase a Domain

curl -X POST "https://developers.hostinger.com/api/domains/v1/portfolio" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "my-new-domain.com",
    "item_id": "hostingercom-domain-com-usd-1y",
    "payment_method_id": 1327362,
    "domain_contacts": {
      "owner_id": 741288,
      "admin_id": 741288,
      "billing_id": 741288,
      "tech_id": 741288
    }
  }'

Get item_id from the billing catalog. If no payment method is provided, your default is used. If no WHOIS info is provided, default contact information for that TLD is used.

List and View Domains

# List all domains
curl -X GET "https://developers.hostinger.com/api/domains/v1/portfolio" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Get domain details
curl -X GET "https://developers.hostinger.com/api/domains/v1/portfolio/example.com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

Configure Nameservers

curl -X PUT "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/nameservers" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ns1": "ns1.custom-dns.com",
    "ns2": "ns2.custom-dns.com"
  }'

Domain Forwarding

# Create forwarding (301 permanent redirect)
curl -X POST "https://developers.hostinger.com/api/domains/v1/forwarding" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "old-domain.com",
    "redirect_type": "301",
    "redirect_url": "https://new-domain.com"
  }'

# Get forwarding config
curl -X GET "https://developers.hostinger.com/api/domains/v1/forwarding/old-domain.com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Delete forwarding
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/forwarding/old-domain.com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

Domain Lock & Privacy Protection

# Enable domain lock (prevent transfers)
curl -X PUT "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/domain-lock" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Disable domain lock (before transfer)
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/domain-lock" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Enable privacy protection
curl -X PUT "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/privacy-protection" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Disable privacy protection
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/privacy-protection" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

WHOIS Profile Management

# List WHOIS profiles (optionally filter by TLD)
curl -X GET "https://developers.hostinger.com/api/domains/v1/whois?tld=com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Create a WHOIS profile
curl -X POST "https://developers.hostinger.com/api/domains/v1/whois" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tld": "com",
    "entity_type": "individual",
    "country": "US",
    "whois_details": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "[e-mail]",
      "phone": "+1.5551234567",
      "address": "123 Main St",
      "city": "New York",
      "state": "NY",
      "zip": "10001"
    }
  }'

# Check which domains use a WHOIS profile
curl -X GET "https://developers.hostinger.com/api/domains/v1/whois/741288/usage" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Delete a WHOIS profile
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/whois/741288" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

API Reference

Availability

Method	Endpoint	Description
POST	/api/domains/v1/availability	Check domain availability (rate limit: 10/min)

Portfolio

Method	Endpoint	Description
GET	/api/domains/v1/portfolio	List all domains
POST	/api/domains/v1/portfolio	Purchase a new domain
GET	/api/domains/v1/portfolio/{domain}	Get domain details
PUT	/api/domains/v1/portfolio/{domain}/nameservers	Update nameservers
PUT	/api/domains/v1/portfolio/{domain}/domain-lock	Enable domain lock
DELETE	/api/domains/v1/portfolio/{domain}/domain-lock	Disable domain lock
PUT	/api/domains/v1/portfolio/{domain}/privacy-protection	Enable privacy protection
DELETE	/api/domains/v1/portfolio/{domain}/privacy-protection	Disable privacy protection

Forwarding

Method	Endpoint	Description
POST	/api/domains/v1/forwarding	Create domain forwarding
GET	/api/domains/v1/forwarding/{domain}	Get forwarding config
DELETE	/api/domains/v1/forwarding/{domain}	Delete forwarding

WHOIS

Method	Endpoint	Description
GET	/api/domains/v1/whois	List WHOIS profiles
POST	/api/domains/v1/whois	Create WHOIS profile
GET	/api/domains/v1/whois/{whoisId}	Get WHOIS profile
DELETE	/api/domains/v1/whois/{whoisId}	Delete WHOIS profile
GET	/api/domains/v1/whois/{whoisId}/usage	Get profile usage

Best Practices

Registration

• Always check availability before attempting to purchase
• Ensure WHOIS profile exists for the target TLD before registering
• Some TLDs require additional_details — check requirements per TLD
• Keep domain lock enabled to prevent unauthorized transfers

Security

• Enable privacy protection to hide personal information from public WHOIS
• Enable domain lock on all production domains
• Only disable domain lock immediately before an intended transfer

Nameservers

• Improper nameserver configuration makes the domain unresolvable
• Always have at least 2 nameservers configured
• Verify nameservers are responding before switching

Forwarding

• Use 301 (permanent) for SEO-preserving redirects
• Use 302 (temporary) for short-term redirects
• Remove forwarding before pointing the domain to hosting

Troubleshooting

Domain Not Resolving After Nameserver Change

• Nameserver changes can take up to 48 hours to propagate
• Verify new nameservers are configured correctly: dig NS example.com
• Check that DNS records exist on the new nameserver

Domain Purchase Failed

• Check registration status in hPanel
• Verify WHOIS profile is complete for the target TLD
• Ensure payment method has sufficient funds

Domain Lock Cannot Be Disabled

• Some TLDs have registrar-imposed lock periods after registration
• Contact support if the lock state doesn't change

WHOIS Profile Deletion Fails

• Profile may be in use by active domains
• Check usage with the /whois/{whoisId}/usage endpoint first

See Also

The following deep-dive guide is available in this skill directory:

• transfer-guide.md — Domain purchase workflow, nameserver configuration, transfer procedures, WHOIS management, and bulk operations (TypeScript/PHP examples)

References

• Hostinger API Documentation
• Hostinger API Changelog
• Python SDK
• TypeScript SDK
• PHP SDK
• CLI Tool