# REST API Reference (https://developer.godaddy.com/en/docs/references/rest)



## Domain Lifecycle

### Domains & DNS

Manage domain registrations, DNS records, privacy settings, and transfers. Operations span version namespaces: **v1** is the original REST API; **v2** added async processing (action queues, notifications, and status polling) in 2019; **v3** is the newest API with a quote-execute registration model. Machine-readable OpenAPI specs: [domains-v1.json](https://developer.godaddy.com/openapi/domains-v1.json) and [domains-v2.json](https://developer.godaddy.com/openapi/domains-v2.json).

<DomainVersionTabs />

***

## Domain Marketplace & Aftermarket

### Aftermarket API

Auction-related actions exclusive to allowlisted reseller partners (list, bid on, and manage aftermarket domain listings. Auth: sso-key).

<Cards>
  <Card href="/docs/references/rest/aftermarket/aftermarket" title="Aftermarket" description="List and manage aftermarket domain auction actions for allowlisted partners." />
</Cards>

### Auctions API

Domain auction operations — retrieve active auctions, place bids, and manage auction state. Auth: sso-key.

<Cards>
  <Card href="/docs/references/rest/auctions/auctions" title="Auctions" description="Retrieve and interact with domain auctions." />
</Cards>

### Transactions API

List and read store transactions, signatures, and reference data from the Transactions API v2.

<Cards>
  <Card href="/docs/references/rest/transactions/general-endpoints" title="Transactions" description="List transactions, fetch detail, and read signatures and references." />
</Cards>

***

## Domain Monetization

### Parking API

Domain parking configuration — enable, disable, and manage monetized parked-page settings for domains. Auth: sso-key.

<Cards>
  <Card href="/docs/references/rest/parking/parking" title="Parking" description="Enable, disable, and configure domain parking and monetization." />
</Cards>

{/* Commerce API — set DOCS_COMMERCE_API_ENABLED=true to show */}

<FeatureGate feature="commerceApiDocs" partial="commerce" />

***

## Customer & Identity

### Agreements API

Retrieve the legal agreements required for domain registration, transfers, and privacy changes. The `agreementKeys` returned here must be passed in the `consent` object when purchasing a domain. Auth: sso-key.

<Cards>
  <Card href="/docs/references/rest/agreements/agreements" title="Agreements" description="Retrieve TLD-specific legal agreements required for domain operations." />
</Cards>

### Shoppers API

Manage shopper accounts, subaccounts, and authentication used by resellers acting on behalf of customers.

<Cards>
  <Card href="/docs/references/rest/shoppers/shoppers" title="Shoppers" description="Create and manage shopper accounts and subaccounts." />
</Cards>

***

## Security & Risk

### Abuse API

Report and manage domain abuse cases. Auth: sso-key.

<Cards>
  <Card href="/docs/references/rest/abuse/v2" title="Abuse v2" description="Report domain abuse, manage abuse cases, and retrieve abuse ticket status." />

  <Card href="/docs/references/rest/abuse/v1-legacy" title="Abuse v1 (Legacy)" description="Legacy abuse reporting endpoints — use v2 for new integrations." />
</Cards>

### Certificates API

Manage SSL/TLS certificate orders, validation, reissuance, and domain verification. Auth: sso-key.

<Cards>
  <Card href="/docs/references/rest/certificates/v1" title="Certificates v1" description="Create, validate, and manage certificate orders. Includes callback registration, email actions, and action polling." />

  <Card href="/docs/references/rest/certificates/v2" title="Certificates v2" description="Create and reissue certificates. Customer-scoped endpoints for certificate details, domain verification, and ACME EAB." />
</Cards>

***

## Platform & Integration

### ANS API

Agent Name Service (ANS) is a decentralized naming layer for registering, resolving, and managing ANS handles and identities. Auth: OAuth.

<Cards>
  <Card href="/docs/references/rest/ans/registration" title="Registration" description="Register and manage ANS handles and names." />

  <Card href="/docs/references/rest/ans/resolution" title="Resolution" description="Resolve ANS handles and names to their linked data." />

  <Card href="/docs/references/rest/ans/search" title="Search" description="Search ANS names and handles." />

  <Card href="/docs/references/rest/ans/validation" title="Validation" description="Validate ANS handles and names." />

  <Card href="/docs/references/rest/ans/agents" title="Agents" description="Manage ANS agent configurations." />

  <Card href="/docs/references/rest/ans/certificate-management" title="Certificate Management" description="Manage certificates within ANS." />

  <Card href="/docs/references/rest/ans/events" title="Events" description="Subscribe to and retrieve ANS events." />

  <Card href="/docs/references/rest/ans/revocation" title="Revocation" description="Revoke ANS registrations." />
</Cards>

### Node.js Hosting API

Deploy and operate Node.js apps on GoDaddy's hosting platform. Manage apps, source uploads, deployments, secrets, and logs.

<Cards>
  <Card href="/docs/references/rest/nodejs-hosting" title="Node.js Hosting" description="REST API for deploying and managing Node.js applications on GoDaddy hosting." />
</Cards>

<FeatureGate feature="commerceApiDocs" partial="graphql-webhooks" />

***

## Reference Data

### Countries API

Country reference data — states and provinces, dialing codes, and country codes for use in contact and address fields. Auth: sso-key.

<Cards>
  <Card href="/docs/references/rest/countries/countries" title="Countries" description="Retrieve country reference data, state/province lists, and dialing codes." />
</Cards>