Domain registrar API
Availability checks, registrations, transfers, WHOIS privacy, and nameserver management in one surface.
-
POST /v1/domains/search
Return availability, pricing, and promo metadata for a single domain or batch.
-
POST /v1/domains/register
Register or transfer a domain using contact + nameserver payloads. Returns domainId and order status.
-
PATCH /v1/domains/{id}/nameservers
Update nameservers, DS records, WHOIS privacy, or request EPP codes with audit tracking.
-
POST /v1/domains/{id}/privacy
Enable or disable WHOIS privacy for a domain. Response includes registry confirmation metadata.
-
GET /v1/domains/{id}/epp
Retrieve the EPP/auth code for transfers. Codes expire automatically after delivery.
{
"domain": "example.com",
"period": 1,
"privacy": true,
"contacts": {
"registrant": {"name": "Alex Example","email": "alex@example.com"}
},
"nameservers": ["ns1.vastrox.net","ns2.vastrox.net"]
}
- Nameserver updates propagate via streaming tasks with status webhooks.
- Privacy toggles return the final registry disposition and reference IDs.
- Transfer events map to `domains.transfer.*` notifications for your billing stack.
{
"method": "POST",
"url": "https://api.vastrox.cloud/v1/domains/register",
"headers": {
"X-API-Key": "sk_docs_public",
"X-API-Timestamp": "1768605012",
"X-API-Signature": "6c01724df91e9156917b34811731a9be647cdef88bca7c84a0bb57e26ee59aba"
},
"body": {
"domain": "api-docs-example.com",
"period": 1,
"privacy": true,
"currency": "EUR",
"nameservers": [
"ns1.vastrox.net",
"ns2.vastrox.net"
]
}
}
{
"echo": {
"domain": "api-docs-example.com",
"period": 1,
"privacy": true,
"currency": "EUR",
"nameservers": [
"ns1.vastrox.net",
"ns2.vastrox.net"
]
},
"request_id": "sim_696ac554662818.41429369",
"domainId": "dom_696ac5546627e",
"status": "pending",
"privacy": true
}
Webhook event: Emits `domains.registered` once the registry confirms activation.