August 10, 2026: Domains API v3 is now available for domain search, registration, and DNS management

We've released Domains API v3, a redesigned API for the domain lifecycle, so you can search for a domain, lock its price with a quote, register it, and manage its DNS — with the final price and required agreements confirmed before you commit to a charge.

What changed

New endpoints are available under /v3/domains, organized around a quote-then-execute flow:

• Discovery — GET /suggestions returns natural-language domain suggestions with TLD filtering; GET /check-availability checks a single domain.
• Registration — POST /registration-quotes locks the price, resolved settings, and required legal agreements behind a single-use quoteToken (10-minute TTL). POST /registrations executes with that token and returns 202 Accepted with a pollable resource: GET /registrations/{registrationId} or GET /operations/{operationId}.
• Domain management — GET /domain-names/{domain-name} retrieves domain details; PUT /domain-names/{domain-name}/nameservers replaces nameservers.
• DNS records — GET/POST /zones/{zone}/dns-records list and create records; DELETE /zones/{zone}/dns-records/{recordId} deletes one.

Authentication uses OAuth 2.0 with per-operation scopes (domains.domain:read, domains.domain:create, domains.nameserver:update, domains.dns:update). Mutating requests require an Idempotency-Key header, so retries are safe and never create duplicate registrations. Resellers act on behalf of customers with the X-Shopper-Id header.

Who is affected

v3 is additive and available to all developers with API access — no action is needed. Existing v1 and v2 integrations are unchanged, and both versions remain available. v3.0 covers domain search, registration, and DNS management; renewals, transfers, contact and privacy management, and bulk operations will arrive in additive v3 minor versions.

Links

• Domains v3 API reference — endpoint documentation

Last updated on