# August 17, 2026: The Domains API now supports listing all domains in an account via GET /v3/domains/domain-names (https://developer.godaddy.com/en/docs/api-users/changelog/domains-list-domain-names)

***

## title: "August 17, 2026: The Domains API now supports listing all domains in an account via GET /v3/domains/domain-names"

August 17, 2026
API
Domains

New

We've added `GET /v3/domains/domain-names` to the Domains API, so you can retrieve a paginated list of all domain names owned by the authenticated account, with filtering to narrow results by lifecycle status.

## What changed

A new endpoint is available:

* `GET /v3/domains/domain-names` — returns a cursor-paginated collection of domains with their status, nameservers, expiry date, auto-renew, privacy, and transfer lock settings.

Four optional query parameters control the results:

* `statuses` — comma-separated list of one or more exact lifecycle statuses (e.g. `?statuses=ACTIVE,EXPIRED`). Accepted values: `ACTIVE`, `EXPIRED`, `PENDING_REGISTRATION`, `PENDING_TRANSFER`, and others defined in `DomainStatus`. Use this when you need to filter on specific known status values.
* `lifecycleGroups` — comma-separated list of coarse lifecycle phases: `PENDING`, `REGISTERED`, `PENDING_TERMINAL`, or `TERMINAL`. Use this when you want stable filtering that continues to work as new statuses are added. `statuses` and `lifecycleGroups` are mutually exclusive; supplying both returns `400`.
* `updatedAfter` — RFC 3339 timestamp; returns only domains last updated after this time.
* `expiresBefore` — RFC 3339 timestamp; returns only domains expiring before this time.
* `pageSize` — number of results per page, 1–200, defaults to 100. Pagination is cursor-based via `pageToken`; offset-based paging is not supported.

## Who is affected

Any developer building portfolio management, renewal automation, or reporting tools on the Domains API. The `domains.domain:read` OAuth scope is required — the same scope used by `GET /v3/domains/domain-names/{domain-name}`.

No existing endpoints are affected.

## Links

* [Domains API reference](https://developer.godaddy.com/docs/references/rest/domains/v3/domains#list-registered-domains) — `GET /v3/domains/domain-names` request parameters and response schema
* [DomainStatus values](https://developer.godaddy.com/docs/references/rest/domains/v3/domains?s-highlight=statuses\&path=statuses%00__0%7Cstatuses%5B%5D%00%23%2Fx-ext%2Fb594312#parameters.query.statuses) — full list of accepted `statuses` values
* [Lifecycle groups](https://developer.godaddy.com/docs/references/rest/domains/v3/domains?s-highlight=lifecycleGroups\&path=lifecycleGroups%00__0%7ClifecycleGroups%5B%5D%00%23%2Fx-ext%2F847c074#parameters.query.lifecyclegroups) — accepted `lifecycleGroups` values