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

We've added GET /v3/domains/domain-names to the Domains API. It returns a paginated list of domain names owned by the authenticated account, with optional filtering 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, autorenew, privacy, and transfer lock settings.

Four optional query parameters control the results:

• statuses: comma-separated list of one or more exact lifecycle statuses (for example, ?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, using pageToken; offset-based paging isn't supported.

Who is affected

Any developer building portfolio management, renewal automation, or reporting tools on the Domains API. You need the domains.domain:read OAuth scope, the same scope that GET /v3/domains/domain-names/{domain-name} uses.

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