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.

Suggest available domains for a query

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Query Parameters

query?string

Natural-language query or keywords describing the desired domain, e.g. "sunrise bakery". Used to generate creative and keyword-spin suggestions.

Lengthlength <= 100

tlds?array<string>

Top-level domains to be included in suggestions.

lengthMax?integer

Maximum length of second-level domain.

Range1 <= value

lengthMin?integer

Minimum length of second-level domain.

Range1 <= value

pageSize?integer

Maximum number of suggestions in the response. Defaults to 10 when omitted.

Default10

Range1 <= value <= 50

sources?array<>

Suggestion source strategies to activate.

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://api.godaddy.com/v3/domains/suggestions?query=sunrise+bakery&tlds=com%2Cnet%2Cshop&sources=EXTENSION%2CKEYWORD_SPIN"

{
  "items": [
    {
      "domain": "sunrisebakery.com",
      "prices": [
        {
          "term": "YEAR",
          "period": 1,
          "price": {
            "currencyCode": "str",
            "value": 0
          },
          "renewalPrice": {
            "currencyCode": "str",
            "value": 0
          }
        }
      ],
      "inventory": "REGISTRY"
    }
  ]
}

{
  "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
    }
  ]
}

Check availability of a single domain

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Query Parameters

domain*string

The domain name to check, in punycode A-label form for IDNs.

optimizeFor?Optimization Target

Optional. When omitted, defaults to SPEED. Availability is always re-verified authoritatively at quote time regardless of this setting.

Default"SPEED"

Value in"SPEED" | "ACCURACY"

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

Response Body

`application/json`

curl -X GET "https://api.godaddy.com/v3/domains/check-availability?domain=example.com&optimizeFor=SPEED&iscCode=ISC_PARTNER_001"

{
  "domain": "coffee24x7x365.com",
  "available": true,
  "definitive": false,
  "inventory": "REGISTRY",
  "prices": [
    {
      "term": "YEAR",
      "period": 1,
      "price": {
        "currencyCode": "USD",
        "value": 1199
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 2299
      }
    },
    {
      "term": "YEAR",
      "period": 2,
      "price": {
        "currencyCode": "USD",
        "value": 3098
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 4598
      }
    },
    {
      "term": "YEAR",
      "period": 3,
      "price": {
        "currencyCode": "USD",
        "value": 4599
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 6897
      }
    },
    {
      "term": "YEAR",
      "period": 5,
      "price": {
        "currencyCode": "USD",
        "value": 9197
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 11495
      }
    }
  ]
}

{
  "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.

Guides

Concepts

Last updated on

Discovery

200application/json

400application/json

401application/json

403application/json

429application/json

200application/json

400application/json

401application/json

403application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`