Register a domain (requires quoteToken)

Full description

Executes a previously quoted domain registration. Irreversible once accepted; creates a charge. Requires a valid unexpired quoteToken, an Idempotency-Key header, and a consent record. Returns a Registration entity; poll links[rel=self] until status is COMPLETED or FAILED.

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Query Parameters

iscCode?string

ISC (International Shopper Code) for pricing context. When provided, prices reflect the applicable rates for this ISC.

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Idempotency-Key*string

Client-generated unique key (UUID recommended). Retrying a mutating request with the same Idempotency-Key returns the original response without creating a duplicate side effect. Required on all execute endpoints.

Length16 <= length <= 64

Request Body

application/json

A domain registration entity created when a POST /registrations request is accepted. Registrations are a top-level resource with their own stable registrationId; the domain relationship is captured in the representation. On POST /registrations, supply the writable fields (domain, period, quoteToken, consent, and optionally profileId/profile). The server returns the full Registration with readOnly fields populated. Poll links[rel=self] until status reaches COMPLETED or FAILED. The same resource is also reachable via GET /operations/{operationId} for clients operating at the abstract level; operationId is included in the representation for that purpose.

registrationId?string

Formatuuid

domain*string

The domain name to register, in punycode A-label form for IDNs. Must match the domain in the quoteToken.

period?integer

Registration period in years. Must match the period in the quote.

Range1 <= value <= 10

Default1

profileId?string

Formatuuid

profile?

quoteToken*string

Formatuuid

consent*

price?

status?Domain Operation Status

operationId?string

Formatuuid

expiresAt?string

Match

^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$

Length20 <= length <= 64

createdAt?string

Match

^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$

Length20 <= length <= 64

updatedAt?string

Match

^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$

Length20 <= length <= 64

Response Body

`application/json`

curl -X POST "https://example.com/registrations?iscCode=ISC_PARTNER_001" \  -H "Idempotency-Key: 9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c" \  -H "Content-Type: application/json" \  -d '{    "domain": "example.com",    "period": 1,    "quoteToken": "7f3a2b1c-9d8e-4012-a5b6-c1d2e3f4a5b6",    "consent": {      "agreementTypes": [        "API_DPA"      ],      "agreedAt": "2026-06-12T10:02:00Z"    }  }'

{  "registrationId": "3a8f1c2d-7e6b-4f9a-b1c0-d2e3f4a5b6c7",  "domain": "example.com",  "period": 1,  "price": {    "currencyCode": "USD",    "value": 1199  },  "consent": {    "agreementTypes": [      "API_DPA"    ],    "agreedAt": "2026-06-12T10:02:00Z",    "agreedBy": {      "type": "DIRECT",      "principal": "550e8400-e29b-41d4-a716-446655440000",      "ip": "203.0.113.7"    }  },  "status": "CONFIRMED",  "operationId": "9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c",  "createdAt": "2026-06-12T10:02:05Z",  "updatedAt": "2026-06-12T10:02:05Z",  "links": [    {      "rel": "self",      "href": "https://api.godaddy.com/v3/domains/registrations/3a8f1c2d-7e6b-4f9a-b1c0-d2e3f4a5b6c7"    }  ]}

Agent & Automation Notes

Scopesdomains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:update

Rate limit60 req/min per credential

On failureGET operations are safe to retry. POST registrations use Idempotency-Key. Poll async operations — do not resubmit.

Guides

Concepts

Last updated on

Register a domain (requires quoteToken)

Authorization

Query Parameters

Header Parameters

Request Body

Response Body

202application/json

400application/json

401application/json

403application/json

409application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`