Operations

Abstract operation polling. Poll GET /operations/{operationId} for any domain mutation until it reaches COMPLETED or FAILED. Operation IDs are unique across Registration, Renewal, and Transfer — clients that prefer typed polling can use the concrete resource endpoints instead.

Poll an async domain operation

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

operationId*string

The server-assigned operation identifier returned in the 202 response of any async domain mutation.

Formatuuid

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

Response Body

`application/json`

curl -X GET "https://example.com/operations/9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c"

{  "operationId": "9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c",  "type": "REGISTER",  "domain": "example.com",  "status": "EXECUTING",  "createdAt": "2026-06-12T10:02:05Z",  "updatedAt": "2026-06-12T10:02:07Z",  "links": [    {      "rel": "self",      "href": "https://api.godaddy.com/v3/domains/operations/9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c"    }  ]}

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

Operations

Poll an async domain operation

Authorization

Path Parameters

Header Parameters

Response Body

200application/json

401application/json

403application/json

404application/json

429application/json

Operation in progress

Registration completed

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`