GoDaddy
Support
API ReferenceDomain LifecycleDomains & DNSv3 (Recommended)

Operations

View as Markdown

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

GET
/operations/{operationId}

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

application/json

application/json

application/json

application/json

curl -X GET "https://api.godaddy.com/v3/domains/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": "/v3/domains/operations/9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c"
    }
  ]
}

{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}

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.

Related

Last updated on

How is this guide?

Records

CRUD operations on DNS records within the GoDaddy-managed zone. Sub-collection of /zones/{zone}. Changes are applied synchronously.

Domains v2

Domains v2 — v1 capabilities plus async operation tracking. Action queues, status polling, notifications, forwarding, and registration under /v2/customers/{customerId}/domains.