# Domains v2 (https://developer.godaddy.com/en/docs/references/rest/domains/v2)

***

title: Domains v2
description: Domains v2 — v1 capabilities plus async operation tracking. Action queues, status polling, notifications, forwarding, and registration under /v2/customers//domains.
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Overview

The `v2` namespace extends the Domains API with async operation tracking — action queues, status polling, and lifecycle notifications. Operation paths follow `/v2/customers/{customerId}/domains/...`.

Use `v2` when you need to track long-running writes (transfers, redemptions) that return `202 Accepted` instead of completing synchronously. For a task-shaped guide layered on top of these endpoints, see [Use the API → Domains](https://developer.godaddy.com/docs/api-users/manage-domains).

The complete OpenAPI spec for the v2 namespace is available at [/openapi/domains-v2.json](https://developer.godaddy.com/openapi/domains-v2.json) — useful for code generation, SDK tooling, and LLM context.

## Operation groups

The v2 namespace is organized into seven operation groups, each rendered on its own reference page below.

## Authentication and scopes

Every v2 operation requires an `Authorization` header carrying a Personal Access Token (Bearer) or a legacy `sso-key` credential. The principal must additionally be authorized for the customer named in the URL. PATs use the granular Domains & DNS scopes listed in [Authentication](https://developer.godaddy.com/docs/api-users/auth), such as `domains.domain:read`, `domains.domain:update`, and `domains.transfer:execute`.

## v2-only capabilities

Some operations have no v1 equivalent and must be reached through `v2`:

* **Domain forwarding** (HTTP redirects on a domain).
* **Notification subscriptions** (lifecycle events delivered to a callback or pulled on demand).
* **Customer-scoped change-of-registrant** (managed across customer boundaries).

## Conventions

| Concern                                              | Where it's documented                                                |
| ---------------------------------------------------- | -------------------------------------------------------------------- |
| Error envelope and retry semantics                   | [Errors](https://developer.godaddy.com/docs/api-users/errors)                                     |
| Rate limits (60 requests/minute per credential)      | [Rate limits](https://developer.godaddy.com/docs/api-users/rate-limits)                           |
| Asynchronous-write polling via the `Action` resource | [Actions reference](https://developer.godaddy.com/docs/references/rest/domains/v2/domain-actions) |