# August 17, 2026: Domain availability and suggestion results now include `firstTermPrice` and `recommended` pricing fields (https://developer.godaddy.com/en/docs/api-users/changelog/domains-pricing-firsttermprice-recommended)

***

## title: "August 17, 2026: Domain availability and suggestion results now include `firstTermPrice` and `recommended` pricing fields"

August 17, 2026
API
Domains

Changed

We've added two optional fields to the `TermPrice` entries returned by `POST /v3/domains/check-availability`, `GET /v3/domains/check-availability`, and `GET /v3/domains/suggestions`, so you can surface promotional pricing and highlight the best-value term to customers without additional logic.

`firstTermPrice` is the discounted price for only the first term unit within a multi-year period — present when a first-term promotion applies to that period and typically omitted when `period` is 1 (where it equals `price`). `recommended` is a boolean flag that, when `true`, marks the best-value term based on active discounts or promotions; at most one entry in the `prices` array carries this flag, and it is absent rather than `false` when no recommendation applies.

Both fields are optional and additive. Existing integrations that do not read them are unaffected and require no changes.

## Links

* [Domains API reference](https://developer.godaddy.com/docs/references/rest/domains/v3/discovery?s-highlight=firstTermPrice\&path=response%00%23%2Fcomponents%2Fschemas%2FAvailability%7Cprices%5B%5D%00%23%2Fx-ext%2F50f74db#response.200.applicationjson.response) — updated `TermPrice` schema