---
title: "List account domains"
method: GET
path: "/account/domain-registrations"
tags: ["account"]
---

# List account domains

`GET /account/domain-registrations`

## Request

- Base URL: `https://api.unstoppabledomains.com/partner/v3`
- URL: `https://api.unstoppabledomains.com/partner/v3/account/domain-registrations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/reseller-api/docs/account/domain-registrations/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of the domains in your account.

Results are returned using cursor-based pagination. Omit `$cursor` to fetch the first page, then pass the `next.$cursor` value from the previous page response to fetch each subsequent page. When `next` is `null` there are no more pages.

Use `$expand=flags` to additionally include the EPP domain flags for each returned domain.

## Query parameters

- `$cursor` string
- `$expand` string[]

## Response `200`

A page of domains in your account

- AccountDomainListResponse
  - `@type` 'unstoppabledomains.com/partner.v3.CursorList', required
  - `items` AccountDomainResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.AccountDomain', required
    - `name` string, required: The fully qualified domain name.
    - `status` 'REGISTERED' | 'REGISTERED_EXTERNAL' | 'REGISTRATION_PROCESSING' | 'DEACTIVATED' | 'EXPIRED_GRACE_PERIOD' | 'EXPIRED_PENDING_DELETE' | 'EXPIRED_REDEMPTION_PERIOD' | 'TRANSFER_INBOUND_PROCESSING', required: The current registration status of the domain.
    - `namingSystem` 'UNS' | 'ICANN' | 'ENS', required: The naming system the domain is registered under.
    - `blockchain` 'MATIC' | 'ETH' | 'ZIL' | 'BASE' | 'SOL' | 'SONIC': The blockchain the domain is minted on. Present for tokenized (web3) domains only.
    - `expirationTimestamp` integer, nullable, required: Unix epoch timestamp (milliseconds) when the domain expires, or `null` when the domain has no expiration.
    - `flags` DomainFlagsSubResponse
      - `DNS_RESOLUTION` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
      - `DNS_TRANSFER_OUT` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
      - `DNS_DELETE` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
      - `DNS_UPDATE` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
      - `DNS_RENEW` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
      - `DNS_WHOIS_PROXY` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
      - `DNS_UNS_TOKENIZATION` DomainFlagConfigurationResponse, required
        - `@type` 'unstoppabledomains.com/partner.v3.DomainFlag', required
        - `status` 'ENABLED' | 'DISABLED', required
        - `readonly` DomainFlagConfigurationReadonlyResponse
          - `state` boolean, required
          - `reasons` object[], required
  - `next` CursorListResponseNext, required
    - `$cursor` string

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Insufficient permissions
- `500`: Internal server error

## Changes

- **2026-06-04** `a692dbb28a09`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/account/domain-registrations/get.md)

---

[API](https://skmtc.dev/unstoppabledomains/apis/reseller-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/reseller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/reseller-api/revisions/e0ac88d02fe7?raw)