Terminal
Terminal/Skill
Lets your agent check domain availability, register domains, and manage nameservers, forwarding, WHOIS, locks and privacy on Hostinger.
By Hostinger
Works with
npx skills add hostinger/hostinger-agent-skills --skill domainsThe Domains API provides full domain lifecycle management — from checking availability and purchasing to configuring nameservers, forwarding, WHOIS profiles, domain locks, and privacy protection.
Your domain portfolio contains all domains registered under your Hostinger account. Each domain has configuration for nameservers, WHOIS contacts, lock status, and privacy protection.
Before purchasing, check if a domain name is available across one or more TLDs. The API also supports alternative domain suggestions.
Redirect a domain to another URL using 301 (permanent) or 302 (temporary) redirects.
Contact information associated with domain registrations. Each TLD may require specific WHOIS details. Profiles can be reused across multiple domains.
Prevents unauthorized domain transfers. Must be disabled before transferring a domain to another registrar.
Hides the domain owner's personal information from public WHOIS databases.
Some operations require proof that you control a domain. The Domain Access Verifier returns the pending and completed verifications for a set of domains, so you can check verification status before relying on a domain.
Note: This endpoint lives under a different base path —
/api/v2/direct/verifications/active— not/api/domains/v1/.
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.,
comnot.com). For alternatives, provide only one TLD.
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_idfrom 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 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"
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"
}'
# 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"
# 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"
# 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": "john@example.com",
"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"
# Get pending and completed verifications for one or more domains
curl -X GET "https://developers.hostinger.com/api/v2/direct/verifications/active" \
-H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "domains": ["example.com", "example.net"] }'
| Method | Endpoint | Description |
|---|---|---|
POST | /api/domains/v1/availability | Check domain availability (rate limit: 10/min) |
| 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 |
| 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 |
| 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 |
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v2/direct/verifications/active | Get pending and completed domain verifications (body: domains string array) |
additional_details — check requirements per TLD301 (permanent) for SEO-preserving redirects302 (temporary) for short-term redirectsdig NS example.com/whois/{whoisId}/usage endpoint firstThe 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)