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

---
title: REST API Reference
description: Complete REST API documentation with interactive examples
full: true
pageId: c1d12cbc-9550-4f33-8467-f1c9f6fce42f
---

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

***

## Domain Marketplace & Aftermarket

### Aftermarket API

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

### Auctions API

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

***

## Domain Monetization

### Parking API

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

## Commerce APIs

PAT-scoped Commerce APIs. Every operation below maps to scopes in
[Commerce API Scopes](https://developer.godaddy.com/docs/references/rest/commerce-scopes).

### Commerce API scopes

### Stores & channels

### Products & inventory

Products through the catalog subgraph.

### Customers & orders

***

## Email

### Email API

List and provision email mailboxes for domains on your account. Auth: OAuth2 (client credentials).

***

## 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.

### Shoppers API

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

***

## Security & Risk

### Abuse API

Report domain and hosting abuse, and track the tickets you have reported. Requires onboarding — contact [abuseapisupport@godaddy.com](mailto:abuseapisupport@godaddy.com). Auth: Classic API Key (sso-key).

### Certificates API

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

***

## Platform & Integration

### ANS API

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

### Hosting API

Manage applications on GoDaddy hosting. Deploy, manage versions, configure environments, and view logs.

***

## 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.