GoDaddy
Support
API ReferenceDomain LifecycleDomains & DNSv3 (Recommended)

Registration Quotes

View as Markdown

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

Quote a single-domain registration (no commitment)

POST
/registration-quotes

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

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.godaddy.com/v3/domains/registration-quotes?iscCode=ISC_PARTNER_001" \  -H "Content-Type: application/json" \  -d '{    "domain": "example.com"  }'
{
  "quoteToken": "7f3a2b1c-9d8e-4012-a5b6-c1d2e3f4a5b6",
  "expiresAt": "string",
  "domain": "example.com",
  "available": true,
  "price": {
    "currencyCode": "str",
    "value": 0
  },
  "renewalPrice": {
    "currencyCode": "str",
    "value": 0
  },
  "period": 1,
  "resolved": {
    "profileId": "14514a29-5fce-4624-8d8a-d8abd56015e2",
    "contactSource": "PROFILE",
    "registrantSummary": "Jane Smith / jane@example.com",
    "autoRenew": true,
    "privacy": true,
    "nameServers": [
      "ns01.domaincontrol.com",
      "ns02.domaincontrol.com"
    ]
  },
  "requiredAgreements": [
    {
      "agreementType": "API_DPA",
      "title": "Domain Name Registration Agreement",
      "url": "https://www.godaddy.com/agreements/showdoc?pageid=reg_sa"
    }
  ],
  "irreversible": false
}
{
  "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
    }
  ]
}

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?

Discovery

Indicative, non-committing operations for finding and checking domains. Use suggestDomains for natural-language queries and getDomainAvailability for specific domain verification. Both return indicative pricing; locked pricing is established only at quote time. The check-availability controller carries no persistent identity.

Registrations

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