August 17, 2026: The Domains API now surfaces and supports purchasing Afternic Premium domains

Afternic Premium domain inventory is now discoverable and purchasable through the Domains API. Four existing endpoints are updated to support the Premium acquisition flow.

What changed

Availability endpoints — POST /v3/domains/check-availability and GET /v3/domains/check-availability

Results may now include domains with inventory: PREMIUM. These are Afternic fast-transfer domains. Indicative pricing for Premium domains includes a fees array on each TermPrice entry containing a ONE_TIME_PREMIUM_DOMAIN_PURCHASE fee, in addition to the base registration price.

Quote endpoint — POST /v3/domains/registration-quotes

When the quoted domain has inventory: PREMIUM, the response now includes:

• inventory: PREMIUM — identifies the domain as Afternic inventory.
• fees array — contains a ONE_TIME_PREMIUM_DOMAIN_PURCHASE entry with the exact amount and currency. The total cost of the registration is price plus this fee.

For standard REGISTRY domains, fees is absent and behavior is unchanged.

Registration endpoint — POST /v3/domains/registrations

When the preceding quote's fees array is non-empty (i.e. inventory: PREMIUM), the execute request must include consent.acknowledgedFees containing the same entries verbatim — same types, amounts, and currencies — copied from the quote response. This confirms the customer explicitly accepted the specific charge before the irreversible purchase is executed.

Omitting consent.acknowledgedFees when fees are present returns 422 with error name consent_fees_required. Supplying acknowledgedFees that does not match the locked quote returns 422 with error name quote_mismatch.

Who is affected

Developers building domain purchase flows who want to offer Afternic Premium inventory must handle the new fees field on quotes and echo it in consent.acknowledgedFees on registration.

Integrations that only purchase standard REGISTRY domains are unaffected — fees is absent for those domains and no changes to existing request or response handling are required.

What to do

1. Check inventory on availability and quote responses. When inventory: PREMIUM, surface the fees total to the customer alongside the base price before they confirm.
2. On POST /v3/domains/registrations, include consent.acknowledgedFees copied verbatim from the quote's fees array when fees are present.
3. Handle the new 422 consent_fees_required error for the case where fees were present but acknowledgedFees was omitted.

Links

• Domains API reference — Domains v3 API reference
• RegistrationQuote schema — updated RegistrationQuote response including fees
• Consent schema — consent.acknowledgedFees field on the registration request body

Last updated on