GoDaddy
Support
API ReferenceDomain LifecycleDomains & DNSv3 (Recommended)

Registrations

View as Markdown

Top-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}).

Register a domain (requires quoteToken)

POST
/registrations

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.godaddy.com/v3/domains/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": "/v3/domains/registrations/3a8f1c2d-7e6b-4f9a-b1c0-d2e3f4a5b6c7"
    }
  ]
}
{
  "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
    }
  ]
}
{
  "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
    }
  ]
}

Get a registration record

GET
/registrations/{registrationId}

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

registrationId*string

Server-assigned registration identifier.

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/registrations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "registrationId": "string",
  "domain": "example.com",
  "period": 1,
  "profileId": "string",
  "profile": {
    "contacts": {
      "registrant": {
        "firstName": "Jane",
        "lastName": "Smith",
        "organization": "Example LLC",
        "email": "string",
        "phone": {
          "countryCode": "str",
          "nationalNumber": "string",
          "extensionNumber": "string"
        },
        "address": {
          "line1": "string",
          "line2": "string",
          "city": "string",
          "state": "string",
          "countryCode": "st",
          "postalCode": "string"
        }
      },
      "admin": {
        "firstName": "Jane",
        "lastName": "Smith",
        "organization": "Example LLC",
        "email": "string",
        "phone": {
          "countryCode": "str",
          "nationalNumber": "string",
          "extensionNumber": "string"
        },
        "address": {
          "line1": "string",
          "line2": "string",
          "city": "string",
          "state": "string",
          "countryCode": "st",
          "postalCode": "string"
        }
      },
      "tech": {
        "firstName": "Jane",
        "lastName": "Smith",
        "organization": "Example LLC",
        "email": "string",
        "phone": {
          "countryCode": "str",
          "nationalNumber": "string",
          "extensionNumber": "string"
        },
        "address": {
          "line1": "string",
          "line2": "string",
          "city": "string",
          "state": "string",
          "countryCode": "st",
          "postalCode": "string"
        }
      },
      "billing": {
        "firstName": "Jane",
        "lastName": "Smith",
        "organization": "Example LLC",
        "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": [
      "ns1.example.com",
      "ns2.example.com"
    ]
  },
  "quoteToken": "7f3a2b1c-9d8e-4012-a5b6-c1d2e3f4a5b6",
  "consent": {
    "agreementTypes": [
      "API_DPA"
    ],
    "agreedAt": "string",
    "agreedBy": {
      "type": "DIRECT",
      "principal": "shopper_123",
      "actor": "agent:claude/atlas-1",
      "ip": "203.0.113.7"
    }
  },
  "status": "string",
  "operationId": "9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c",
  "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
    }
  ]
}
{
  "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?

Registration Quotes POST

Quote a domain registration. Returns a locked price, resolved settings, required agreements, and a single-use quoteToken. Free and read-only.

Domains GET

The core domain entity collection. Supports listing and reading owned domain records, and cancelling registrations.