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

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 — GET /v3/domains/domain-names request parameters and response schema
• DomainStatus values — full list of accepted statuses values
• Lifecycle groups — accepted lifecycleGroups values

Last updated on