August 17, 2026: Domain availability and suggestion results now include `firstTermPrice` and `recommended` pricing fields
View as MarkdownWe'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 — updated
TermPriceschema
Last updated on
How is this guide?