# GoDaddy

URL: https://docs.hanzo.ai/docs/guides/migrate/godaddy

> GoDaddy sells and holds domains. Here that is /v1/domain — seven operations covering availability, search, purchase, renewal and transfer.

GoDaddy is a registrar: it prices a name, sells it to you, and keeps it
registered. `/v1/domain` (7 operations) does the same five things — check,
search, buy, renew, transfer — plus list what you own and report whether the
registrar is reachable.

## Start here

Mint a key, price the name you want, and you are one POST from owning it.

```bash
# 1. mint a key — sk- belongs on a server, pk- is safe in a browser
curl -sS -X POST https://api.hanzo.ai/v1/account/keys \
  -H "Authorization: Bearer $HANZO_SESSION" \
  -H 'Content-Type: application/json' \
  -d '{"type":"secret"}'

# 2. check exact names — comma-separate to do several in one call
curl -sS "https://api.hanzo.ai/v1/domain/availability?domain=example.com,example.ai" \
  -H "Authorization: Bearer $HANZO_API_KEY"

# 3. taken? build candidates from a keyword, narrowed to the TLDs you'd take
curl -sS "https://api.hanzo.ai/v1/domain/search?q=example&tld=com,ai" \
  -H "Authorization: Bearer $HANZO_API_KEY"
```

Two GETs, nothing charged and nothing held — a quote is not a reservation, and
the price is re-quoted at purchase. Both answer the same shape: `available`,
`premium`, first-term and renewal price in cents. Priced names back mean the key
is valid and the registrar credentials are live; a deployment missing them
answers 503, not an empty list.

### Core capabilities

| Capability     | What it does                                                                | Operations |
| -------------- | --------------------------------------------------------------------------- | ---------- |
| `/v1/domain`   | Check, search, buy, renew and transfer names, and list what the org holds   | 7          |
| `/v1/projects` | Put a site on the name — deploy, release, attach a host and verify it       | 27         |
| `/v1/seo`      | Audit one live page, and pull keywords, rankings, backlinks and competitors | 7          |

## Nouns

| GoDaddy                                                                | Hanzo                                                           |
| ---------------------------------------------------------------------- | --------------------------------------------------------------- |
| `GET /v3/domains/check-availability?domain=`                           | `GET /v1/domain/availability?domain=`                           |
| Alternate-TLD suggestions                                              | `GET /v1/domain/search?q=`, narrowed by `tld`                   |
| `POST /v3/domains/registration-quotes` — locking a price               | No quote step. `register` answers the `quote` it bought at      |
| `quoteToken`                                                           | Nothing. There is no token to carry between calls               |
| `POST /v3/domains/registrations`                                       | `POST /v1/domain/register` — `domain`, `years`, `contacts`      |
| `GET /v3/domains/registrations/{registrationId}` — poll to `COMPLETED` | Nothing to poll. The register call answers the ownership record |
| List your domains (their v1)                                           | `GET /v1/domain/domains`                                        |
| Renew a name you hold (their v1)                                       | `POST /v1/domain/renew` — `domain`, `years`                     |
| Transfer with an auth code (their v1)                                  | `POST /v1/domain/transfer` — `domain`, `authCode`, `years`      |
| `{"currencyCode": "USD", "value": 1199}`                               | `priceCents` and `renewalPriceCents`, with `currency`           |
| Registrant, admin, tech and billing contacts                           | `contacts.registrant`, `.admin`, `.tech`, `.billing`            |

Availability, search, register, renew and transfer all answer the same quote
shape, so the price you see when checking is the price shape you get when buying.

## The call

GoDaddy — four calls, because the price is locked between two of them:

```bash
# 1. Check.
curl -sS "https://api.godaddy.com/v3/domains/check-availability?domain=example.com" \
  -H "Authorization: Bearer $GODADDY_PAT"

# 2. Lock a price. Answers a quoteToken with an expiry.
curl -sS -X POST https://api.godaddy.com/v3/domains/registration-quotes \
  -H "Authorization: Bearer $GODADDY_PAT" \
  -H 'Content-Type: application/json' \
  -d '{"domain": "example.com", "period": 1}'

# 3. Execute, against that token, with recorded consent.
curl -sS -X POST https://api.godaddy.com/v3/domains/registrations \
  -H "Authorization: Bearer $GODADDY_PAT" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{
    "quoteToken": "qt_abc123",
    "domain": "example.com",
    "period": 1,
    "consent": {"agreedAt": "2026-01-15T10:30:00.000Z", "agreementTypes": ["API_DPA"]}
  }'

# 4. Poll until COMPLETED or FAILED.
curl -sS https://api.godaddy.com/v3/domains/registrations/reg_xyz789 \
  -H "Authorization: Bearer $GODADDY_PAT"
```

Hanzo — two:

```bash
# 1. Check. Answers purchasable, premium, first-term and renewal price in cents.
curl -sS "https://api.hanzo.ai/v1/domain/availability?domain=example.com" \
  -H "Authorization: Bearer $HANZO_API_KEY"

# 2. Buy. Answers the ownership record together with the quote it was bought at.
curl -sS -X POST https://api.hanzo.ai/v1/domain/register \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "example.com",
    "years": 1,
    "contacts": {
      "registrant": {
        "firstName": "Ada",
        "lastName": "Lovelace",
        "email": "ada@example.com",
        "phone": "+1.2125550100",
        "address1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "country": "US"
      }
    }
  }'
```

The record carries `domain`, `expiresAt`, `nameservers`, `priceCents`,
`costCents` and the org that owns it. Renewal answers the updated record with its
new expiry alongside `paidCents`.

`GET /v1/domain/health` reports registrar reachability without flattering it: it
is `ok` only when the wholesale credentials are present and the registrar
accepted them on a live call.

## What does not carry

**No DNS.** GoDaddy manages the zone as well as the registration — records,
nameserver changes, forwarding. `/v1/domain` registers and holds names. The
ownership record reports `nameservers`, and there is no route here that sets
them or edits a record.

**No contact updates after the fact.** Contacts go in at registration. There is
no later edit, so get the registrant right the first time.

**No privacy toggle and no domain forwarding.**

**No quote token and no idempotency key.** GoDaddy separates pricing from
purchase so a price cannot move underneath you, and requires an
`Idempotency-Key` on the registration so a retry cannot double-buy. Neither
exists here: `register` prices and buys in one call, and it answers the quote it
used so you can see what you paid. A retry after a timeout is a second attempt at
a purchase, so check `GET /v1/domain/domains` before you send one.

**No async operation to follow.** GoDaddy answers 202 and hands you a poll URL.
`register` answers when the registration is done or it does not answer at all.