# Overview (https://developer.godaddy.com/en/docs/references/rest/domains/v3)

***

title: Overview
description: >
Reference for the Domains v3 API — a quote-execute model for domain discovery,
registration, and management.
-----------------------------

## Overview

Domains v3 introduces a **quote-execute** model built for clarity and pricing predictability:

1. **Discover** — check availability and get suggestions
2. **Quote** — lock in a price with a `quoteToken`
3. **Register** — execute the registration using that token
4. **Poll** — follow the async operation to completion

All write operations return `202 Accepted` with an operation or registration ID. Poll the returned URL until status reaches `COMPLETED` or `FAILED`.

v3 covers domain discovery, registration, domain reads, nameserver management, and DNS records. Renewals, transfers, contact updates, forwarding, and privacy settings remain on the [v1 API](https://developer.godaddy.com/docs/references/rest/domains/v1) and [v2 API](https://developer.godaddy.com/docs/references/rest/domains/v2).

The complete OpenAPI spec for the v3 namespace is available at [/openapi/domains-v3.json](https://developer.godaddy.com/openapi/domains-v3.json) — useful for code generation, SDK tooling, and LLM context.

## Endpoint groups

## Quote-execute flow

**1. Check availability**

```
GET /v3/domains/check-availability?domain=example.com
```

```json
{
  "domain": "example.com",
  "available": true,
  "prices": [
    { "term": "YEAR", "period": 1, "price": { "currencyCode": "USD", "value": 1199 } }
  ]
}
```

**2. Lock a price**

```
POST /v3/domains/registration-quotes
```

```json
{ "domain": "example.com", "period": 1 }
```

```json
{
  "domain": "example.com",
  "available": true,
  "quoteToken": "qt_abc123...",
  "expiresAt": "2026-01-15T10:45:00.000Z",
  "period": 1,
  "price": { "currencyCode": "USD", "value": 1199 },
  "requiredAgreements": [{ "agreementType": "API_DPA" }]
}
```

**3. Execute the registration**

```
POST /v3/domains/registrations
Idempotency-Key: <uuid>
```

```json
{
  "quoteToken": "qt_abc123...",
  "domain": "example.com",
  "period": 1,
  "consent": {
    "agreedAt": "2026-01-15T10:30:00.000Z",
    "agreementTypes": ["API_DPA"]
  }
}
```

```json
{
  "registrationId": "reg_xyz789...",
  "domain": "example.com",
  "status": "CONFIRMED"
}
```

**4. Poll to completion**

```
GET /v3/domains/registrations/{registrationId}
```

```json
{ "registrationId": "reg_xyz789...", "domain": "example.com", "status": "COMPLETED" }
```

Poll every few seconds until `status` is `COMPLETED` or `FAILED`. You can also use `GET /v3/domains/operations/{operationId}` — both endpoints resolve the same resource.

## Conventions

| Convention           | Detail                                                                       |
| -------------------- | ---------------------------------------------------------------------------- |
| Base URL             | `https://api.godaddy.com`                                                    |
| Version prefix       | `/v3/`                                                                       |
| Async writes         | `202 Accepted` with `links[rel=self]` poll URL                               |
| Idempotency          | `Idempotency-Key` header required on registration                            |
| Indicative vs locked | Availability and suggestions return indicative prices; quotes lock the price |
| Auth                 | `Authorization: Bearer ${GODADDY_PAT}`                                       |

## What v3 does not cover

The following operations are not yet in v3. Use v1 or v2 instead:

| Operation                 | Use instead                                    |
| ------------------------- | ---------------------------------------------- |
| Domain renewals           | [Domains v1](https://developer.godaddy.com/docs/references/rest/domains/v1) |
| Domain transfers          | [Domains v1](https://developer.godaddy.com/docs/references/rest/domains/v1) |
| Contact updates           | [Domains v1](https://developer.godaddy.com/docs/references/rest/domains/v1) |
| Domain forwarding         | [Domains v1](https://developer.godaddy.com/docs/references/rest/domains/v1) |
| Privacy settings          | [Domains v1](https://developer.godaddy.com/docs/references/rest/domains/v1) |
| List owned domains        | [Domains v1](https://developer.godaddy.com/docs/references/rest/domains/v1) |
| Shopper-scoped operations | [Domains v2](https://developer.godaddy.com/docs/references/rest/domains/v2) |