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. Search for a domain, lock its price with a quote, register it, and manage its DNS. The final price and required agreements are 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 /v3/domains/suggestions returns natural-language domain suggestions with TLD filtering; GET /v3/domains/check-availability checks a single domain.
• Registration: POST /v3/domains/registration-quotes locks the price, resolved settings, and required legal agreements behind a single-use quoteToken (10-minute TTL). POST /v3/domains/registrations executes with that token and returns 202 Accepted with a pollable resource: GET /v3/domains/registrations/{registrationId} or GET /v3/domains/operations/{operationId}.
• Domain management: GET /v3/domains/domain-names/{domain-name} retrieves domain details; PUT /v3/domains/domain-names/{domain-name}/nameservers replaces nameservers.
• DNS records: GET/POST /v3/domains/zones/{zone}/dns-records list and create records; DELETE /v3/domains/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. You don't need to take any action. 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