How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GoDaddy Domains API

The Domains API from GoDaddy — 24 operation(s) for domains.

GoDaddy Domains API is one of 13 APIs that GoDaddy publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Domains. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 56 operations across 43 paths, and defines 68 schemas. It is described by OpenAPI 3.2.0.

Requests are made against a single base URL, https://api.ote-godaddy.com.

56 operations 43 paths 68 schemas 6 DELETE17 GET5 PATCH23 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
Base URL
https://api.godaddy.com
Resource Areas
1

Paths & Operations 56

Across 43 paths, the API surfaces 56 operations — 6 DELETE, 17 GET, 5 PATCH, 23 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Domains 56
GET
/v1/domains
Retrieve a list of Domains for the specified Shopper
list 7 params → 200400401403422429500
GET
/v1/domains/agreements
Retrieve the legal agreement(s) required to purchase the specified TLD and…
getAgreement 4 params → 200400401403404429500
GET
/v1/domains/available
Determine whether or not the specified domain is available for purchase
available 3 params → 200400401403422429500
POST
/v1/domains/available
Determine whether or not the specified domains are available for purchase
availableBulk 1 param body → 200203400401403422429500
POST
/v1/domains/contacts/validate
Validate the request body using the Domain Contact Validation Schema for…
ContactsValidate 2 params body → 200204400422429500
POST
/v1/domains/purchase
Purchase and register the specified Domain
purchase 1 param body → 200400401403404422429500
GET
/v1/domains/purchase/schema/{tld}
Retrieve the schema to be submitted when registering a Domain for the specified…
schema 1 param → 200400401403404422429500
POST
/v1/domains/purchase/validate
Validate the request body using the Domain Purchase Schema for the specified TLD
validate body → 200400401403404422429500
GET
/v1/domains/suggest
Suggest alternate Domain names based on a seed Domain, a set of keywords, or…
suggest 10 params → 200400401403404422429500
GET
/v1/domains/tlds
Retrieves a list of TLDs supported and enabled for sale
tlds → 200400401403429500
DELETE
/v1/domains/{domain}
Cancel a purchased domain
cancel 1 param → 200400401403404422429500
GET
/v1/domains/{domain}
Retrieve details for the specified Domain
get 2 params → 200203400401403404422429
PATCH
/v1/domains/{domain}
Update details for the specified Domain
update 2 params body → 200400401403404409422429
PATCH
/v1/domains/{domain}/contacts
Update domain
updateContacts 2 params body → 200204400401403404422429
DELETE
/v1/domains/{domain}/privacy
Submit a privacy cancellation request for the given domain
cancelPrivacy 2 params → 200400401403404422429500
POST
/v1/domains/{domain}/privacy/purchase
Purchase privacy for a specified domain
purchasePrivacy 2 params body → 200400401403404409422429
PATCH
/v1/domains/{domain}/records
Add the specified DNS Records to the specified Domain
recordAdd 2 params body → 200400401403404422429500
PUT
/v1/domains/{domain}/records
Replace all DNS Records for the specified Domain
recordReplace 2 params body → 200400401403404422429500
GET
/v1/domains/{domain}/records/{type}/{name}
Retrieve DNS Records for the specified Domain, optionally with the specified…
recordGet 6 params → 200400401403404422429500
PUT
/v1/domains/{domain}/records/{type}/{name}
Replace all DNS Records for the specified Domain with the specified Type and…
recordReplaceTypeName 4 params body → 200400401403404422429500
DELETE
/v1/domains/{domain}/records/{type}/{name}
Delete all DNS Records for the specified Domain with the specified Type and Name
recordDeleteTypeName 4 params → 204400401403404409422429
PUT
/v1/domains/{domain}/records/{type}
Replace all DNS Records for the specified Domain with the specified Type
recordReplaceType 3 params body → 200400401403404422429500
POST
/v1/domains/{domain}/renew
Renew the specified Domain
renew 2 params body → 200400401403404409422429
POST
/v1/domains/{domain}/transfer
Purchase and start or restart transfer process
transferIn 2 params body → 200400401403409422429500
POST
/v1/domains/{domain}/verifyRegistrantEmail
Re-send Contact E-mail Verification for specified Domain
verifyEmail 2 params → 200400401403404422429500
GET
/v2/customers/{customerId}/domains/{domain}
Retrieve details for the specified Domain
getV2CustomersByCustomerIdDomainsByDomain 4 params → 200203401403404422429500
DELETE
/v2/customers/{customerId}/domains/{domain}/changeOfRegistrant
Cancels a pending change of registrant request for a given domain
deleteV2CustomersByCustomerIdDomainsByDomainChangeOfRegistrant 3 params → 202401403404409422429500
GET
/v2/customers/{customerId}/domains/{domain}/changeOfRegistrant
Retrieve change of registrant information
getV2CustomersByCustomerIdDomainsByDomainChangeOfRegistrant 3 params → 200401403404409422429500
PATCH
/v2/customers/{customerId}/domains/{domain}/dnssecRecords
Add the specifed DNSSEC records to the domain
patchV2CustomersByCustomerIdDomainsByDomainDnssecRecords 3 params body → 202400401403404409422429
DELETE
/v2/customers/{customerId}/domains/{domain}/dnssecRecords
Remove the specifed DNSSEC record from the domain
deleteV2CustomersByCustomerIdDomainsByDomainDnssecRecords 3 params body → 202400401403404409422429
PUT
/v2/customers/{customerId}/domains/{domain}/nameServers
Replaces the existing name servers on the domain
putV2CustomersByCustomerIdDomainsByDomainNameServers 3 params body → 202400401403404409422429
GET
/v2/customers/{customerId}/domains/{domain}/privacy/forwarding
Retrieve privacy email forwarding settings showing where emails are delivered
getV2CustomersByCustomerIdDomainsByDomainPrivacyForwarding 3 params → 200401403404422429500
PATCH
/v2/customers/{customerId}/domains/{domain}/privacy/forwarding
Update privacy email forwarding settings to determine how emails are delivered
patchV2CustomersByCustomerIdDomainsByDomainPrivacyForwarding 3 params body → 202401403404409422429500
POST
/v2/customers/{customerId}/domains/{domain}/redeem
Purchase a restore for the given domain to bring it out of redemption
postV2CustomersByCustomerIdDomainsByDomainRedeem 3 params body → 202401403404409422429500
POST
/v2/customers/{customerId}/domains/{domain}/renew
Renew the specified Domain
postV2CustomersByCustomerIdDomainsByDomainRenew 3 params body → 202400401403404409422429
POST
/v2/customers/{customerId}/domains/{domain}/transfer
Purchase and start or restart transfer process
postV2CustomersByCustomerIdDomainsByDomainTransfer 3 params body → 202400401403404409422429
GET
/v2/customers/{customerId}/domains/{domain}/transfer
Query the current transfer status
getV2CustomersByCustomerIdDomainsByDomainTransfer 3 params → 200400401403404429500
POST
/v2/customers/{customerId}/domains/{domain}/transfer/validate
Validate the request body using the Domain Transfer Schema for the specified TLD
postV2CustomersByCustomerIdDomainsByDomainTransferValidate 3 params body → 204400401403404409422429
POST
/v2/customers/{customerId}/domains/{domain}/transferInAccept
Accepts the transfer in
postV2CustomersByCustomerIdDomainsByDomainTransferInAccept 3 params body → 202400401403404409422429
POST
/v2/customers/{customerId}/domains/{domain}/transferInCancel
Cancels the transfer in
postV2CustomersByCustomerIdDomainsByDomainTransferInCancel 3 params → 202401403404409429500
POST
/v2/customers/{customerId}/domains/{domain}/transferInRestart
Restarts transfer in request from the beginning
postV2CustomersByCustomerIdDomainsByDomainTransferInRestart 3 params → 202401403404409429500
POST
/v2/customers/{customerId}/domains/{domain}/transferInRetry
Retries the current transfer in request with supplied Authorization code
postV2CustomersByCustomerIdDomainsByDomainTransferInRetry 3 params body → 202400401403404409422429
POST
/v2/customers/{customerId}/domains/{domain}/transferOut
Initiate transfer out to another registrar for a .uk domain
postV2CustomersByCustomerIdDomainsByDomainTransferOut 4 params → 202401403404409422429500
POST
/v2/customers/{customerId}/domains/{domain}/transferOutAccept
Accept transfer out
postV2CustomersByCustomerIdDomainsByDomainTransferOutAccept 3 params → 202401403404409429500
POST
/v2/customers/{customerId}/domains/{domain}/transferOutReject
Reject transfer out
postV2CustomersByCustomerIdDomainsByDomainTransferOutReject 4 params → 202401403404409429500
DELETE
/v2/customers/{customerId}/domains/forwards/{fqdn}
Submit a forwarding cancellation request for the given fqdn
domainsForwardsDelete 2 params → 204401403404409422429500
GET
/v2/customers/{customerId}/domains/forwards/{fqdn}
Retrieve the forwarding information for the given fqdn
domainsForwardsGet 3 params → 200401403404422429500
PUT
/v2/customers/{customerId}/domains/forwards/{fqdn}
Modify the forwarding information for the given fqdn
domainsForwardsPut 2 params body → 204401403404409422429500
POST
/v2/customers/{customerId}/domains/forwards/{fqdn}
Create a new forwarding configuration for the given FQDN
domainsForwardsPost 2 params body → 204401403404409422429500
POST
/v2/customers/{customerId}/domains/register
Purchase and register the specified Domain
postV2CustomersByCustomerIdDomainsRegister 2 params body → 202400401403409422429500
GET
/v2/customers/{customerId}/domains/register/schema/{tld}
Retrieve the schema to be submitted when registering a Domain for the specified…
getV2CustomersByCustomerIdDomainsRegisterSchemaByTld 3 params → 200401403404422429500
POST
/v2/customers/{customerId}/domains/register/validate
Validate the request body using the Domain Registration Schema for the…
postV2CustomersByCustomerIdDomainsRegisterValidate 2 params body → 204400401403404422429500
GET
/v2/domains/maintenances
Retrieve a list of upcoming system Maintenances
getV2DomainsMaintenances 5 params → 200400401403422429500
GET
/v2/domains/maintenances/{maintenanceId}
Retrieve the details for an upcoming system Maintenances
getV2DomainsMaintenancesByMaintenanceId 2 params → 200400401403404429500
GET
/v2/domains/usage/{yyyymm}
Retrieve api usage request counts for a specific year/month.
getV2DomainsUsageByYyyymm 3 params → 200401403429500
POST
/v2/customers/{customerId}/domains/{domain}/regenerateAuthCode
Regenerate the auth code for the given domain
postV2CustomersByCustomerIdDomainsByDomainRegenerateAuthCode 3 params → 202401403404409429500

Schemas 68

The contract defines 68 schemas that model the data the API accepts and returns. The most detailed are DomainDetailV2 (26 properties), DomainDetail (25 properties), DomainSummary (23 properties), ContactDomain (19 properties). Each schema is shown below with its type and property counts.

DomainContactsCreateV2
object
8 properties
ConsentRedemption
object
5 properties 5 required
DomainTransferInV2
object
8 properties 2 required
ConsentDomainUpdate
object
3 properties 3 required
Consent
object
3 properties 3 required
VerificationsDomainV2
object
3 properties
DomainNameServerUpdateV2
object
1 property
DomainUpdate
object
7 properties
Contact
object
9 properties 5 required
MaintenanceDetail
object
12 properties 10 required
ErrorLimit
object
4 properties 2 required
JsonSchema
object
4 properties 4 required
ContactRegistrantChange
object
4 properties 3 required
UsageMonthlyDetail
object
2 properties 2 required
ActionReason
object
3 properties 1 required
DomainRenewV2
object
3 properties 2 required
RenewalDetails
object
3 properties 2 required
DomainAvailableBulk
object
1 property 1 required
ContactDomain
object
19 properties 7 required
DomainAvailableBulkMixed
object
2 properties 1 required
DomainTransferAuthCode
object
1 property 1 required
DomainForwarding
object
4 properties 3 required
JsonDataType
object
3 properties 2 required
DNSRecord
object
9 properties 3 required
DomainContactsV2
object
4 properties
DomainPurchase
object
10 properties 2 required
ErrorDomainContactsValidate
object
4 properties 1 required
ErrorFieldDomainContactsValidate
object
5 properties 3 required
Maintenance
object
11 properties 10 required
VerificationRealName
object
1 property 1 required
ConsentV2
object
7 properties 5 required
DomainDnssec
object
7 properties 1 required
DomainAvailableResponse
object
6 properties 3 required
ConsentRenew
object
5 properties 4 required
MaintenanceSystem
object
2 properties 2 required
UsageMonthly
object
4 properties 2 required
LegalAgreement
object
4 properties 3 required
DomainRedeemV2
object
1 property 1 required
DomainRenew
object
1 property
Action
object
9 properties 4 required
PrivacyPurchase
object
1 property 1 required
Address
object
6 properties 5 required
DomainTransferStatus
object
1 property 1 required
DomainTransferIn
object
9 properties 2 required
DomainAvailableError
object
5 properties 4 required
ContactDomainCreate
object
11 properties 6 required
DomainSummary
object
23 properties 12 required
DomainPrivacyForwardingUpdate
object
3 properties 2 required
VerificationDomainName
object
1 property 1 required
DomainSuggestion
object
1 property 1 required
DomainChangeOfRegistrant
object
5 properties 3 required
DomainForwardingMask
object
3 properties
DomainDetailV2
object
26 properties 14 required
DomainContacts
object
4 properties 1 required
TldSummary
object
2 properties 2 required
DomainsContactsBulk
object
7 properties 1 required
Error
object
3 properties 1 required
DomainPrivacyForwarding
object
3 properties
VerificationsDomain
object
2 properties
DomainPurchaseV2
object
8 properties 2 required
DomainForwardingCreate
object
3 properties 2 required
ArrayOfDNSRecord
array
DNSRecordCreateTypeName
object
7 properties 1 required
DomainPurchaseResponse
object
4 properties 3 required
JsonProperty
object
10 properties 3 required
DNSRecordCreateType
object
8 properties 2 required
ErrorField
object
4 properties 2 required
DomainDetail
object
25 properties 17 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

godaddy-domains-api-openapi.yml Raw ↑

Other APIs GoDaddy publishes across the network.

GoDaddy Actions API
GoDaddy Contacts API
GoDaddy Expiry Auctions: Registrar Partners API
GoDaddy Notifications API
GoDaddy Abuse API
GoDaddy Agreements API
GoDaddy Certificates API
GoDaddy Countries API
GoDaddy Customers API
GoDaddy Orders API
GoDaddy Shoppers API
GoDaddy Subscriptions API
Where this information came from

This is an independent, third-party profile of GoDaddy Domains API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.