Registrations
View as MarkdownTop-level registration entity collection. Execute a domain registration by POSTing with a quoteToken, domain, period, and consent. Returns a Registration entity with links to the concrete poll URL (GET /registrations/{registrationId}) and the abstract operation (GET /operations/{operationId}).
Authorization
bearerAuth Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.
In: header
Query Parameters
ISC (International Shopper Code) for pricing context. When provided, prices reflect the applicable rates for this ISC.
Header Parameters
Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.
uuidClient-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.
16 <= length <= 64Request 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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
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" } ]}Authorization
bearerAuth Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.
In: header
Path Parameters
Server-assigned registration identifier.
uuidHeader Parameters
Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/registrations/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "registrationId": null, "domain": "string", "period": 1, "profileId": null, "profile": { "contacts": { "registrant": { "firstName": "string", "lastName": "string", "organization": "string", "email": "string", "phone": { "countryCode": "str", "nationalNumber": "string", "extensionNumber": "string" }, "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "countryCode": "st", "postalCode": "string" } }, "admin": { "firstName": "string", "lastName": "string", "organization": "string", "email": "string", "phone": { "countryCode": "str", "nationalNumber": "string", "extensionNumber": "string" }, "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "countryCode": "st", "postalCode": "string" } }, "tech": { "firstName": "string", "lastName": "string", "organization": "string", "email": "string", "phone": { "countryCode": "str", "nationalNumber": "string", "extensionNumber": "string" }, "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "countryCode": "st", "postalCode": "string" } }, "billing": { "firstName": "string", "lastName": "string", "organization": "string", "email": "string", "phone": { "countryCode": "str", "nationalNumber": "string", "extensionNumber": "string" }, "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "countryCode": "st", "postalCode": "string" } } }, "autoRenew": true, "privacy": true, "nameServers": [ "string", "string" ] }, "quoteToken": null, "consent": { "agreementTypes": [ "string" ], "agreedAt": "string", "acknowledgedFees": [ { "type": null, "fee": { "currencyCode": "str", "value": 0 } } ], "agreedBy": { "type": null, "principal": "string", "actor": "string", "ip": "string" } }, "price": { "currencyCode": "str", "value": 0 }, "fees": [ { "type": null, "fee": { "currencyCode": "str", "value": 0 } } ], "status": null, "operationId": null, "expiresAt": "string", "createdAt": "string", "updatedAt": "string", "links": [ { "href": "http://example.com", "rel": "string", "title": "string", "targetMediaType": "string", "targetSchema": null, "method": "string", "submissionMediaType": "application/json", "submissionSchema": null } ]}Agent & Automation Notes
domains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:updateRelated
Last updated on
How is this guide?