# August 17, 2026: The Domains API now surfaces and supports purchasing Afternic Premium domains (https://developer.godaddy.com/en/docs/api-users/changelog/domains-afternic-premium)

***

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

August 17, 2026
API
Domains

ChangedAction Required

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](https://developer.godaddy.com/docs/references/rest/domains/v3) — Domains v3 API reference
* [RegistrationQuote schema](https://developer.godaddy.com/docs/references/rest/domains/v3/registration-quotes?s-highlight=fees\&path=response%00%23%2Fcomponents%2Fschemas%2FRegistrationQuote#response.200.applicationjson.response) — updated `RegistrationQuote` response including `fees`
* [Consent schema](https://developer.godaddy.com/docs/references/rest/domains/v3/registrations?s-highlight=acknowledgedFees\&path=body%00%23%2Fcomponents%2Fschemas%2FRegistration%7Cconsent%00__29#request-body.applicationjson.body) — `consent.acknowledgedFees` field on the registration request body