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

***

title: Domains v1
description: Account-scoped Domains operations under /v1/domains. Search, register, list, DNS, privacy, renewals, and transfer.
-------------------------------------------------------------------------------------------------------------------------------

## Overview

The `v1` namespace exposes Domains operations that act on the domains owned by the authenticated account. Caller identity is established by the `Authorization` header alone; some operations also accept an `X-Shopper-Id` header to act on behalf of a specific shopper.

The `v1` namespace is account-scoped; use `v2` when you need async operation tracking (action queues, status polling, and notifications). 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 v1 namespace is available at [/openapi/domains-v1.json](https://developer.godaddy.com/openapi/domains-v1.json) — useful for code generation, SDK tooling, and LLM context.

## Operation groups

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

## Authentication and scopes

Every v1 operation requires an `Authorization` header carrying a Personal Access Token (Bearer) or a legacy `sso-key` credential. PATs use the granular Domains & DNS scopes listed in [Authentication](https://developer.godaddy.com/docs/api-users/auth), like `domains.domain:read`, `domains.domain:update`, `domains.dns:update`, and `domains.transfer:execute`.

## 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) |
| Cursor-based pagination on `GET /v1/domains`    | [Pagination](https://developer.godaddy.com/docs/api-users/pagination)   |