---
title: "Search for owned domains by one or more addresses"
method: GET
path: "/search/owners/domains"
tags: ["search"]
---

# Search for owned domains by one or more addresses

`GET /search/owners/domains`

## Query parameters

- `$expand` string[] — Use `$expand` options to conditionally include portions of the response
- `owner.address` string[], required
- `$cursor` string

## Response `200`

- DomainSearchListResponse
  - `@type` 'unstoppabledomains.com/partner.v3.CursorList', required
  - `items` MinimalDomainSearchResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.DomainMinimal', required
    - `name` string, required
    - `blockchain` 'MATIC' | 'ETH' | 'ZIL'
    - `owner` DomainOwnerResponse
      - `type` 'NONE' | 'UD' | 'SELF' | 'EXTERNAL', required — - `NONE`: Domain is not currently owned by anyone - `UD`: Domain is owned by a wallet/contract that belongs to Unstoppable Domains - `SELF`: Domain is owned by your account. You can manage this domains through the API - `EXTERNAL`: Owner doesn't qualify as any of the above.
      - `address` string
    - `availability` DomainAvailabilityResponse
      - `status` 'AVAILABLE' | 'AVAILABLE_FROM_ISSUER' | 'REGISTERED' | 'PROTECTED' | 'COMING_SOON' | 'DISALLOWED' | 'RESERVED' | 'EXCEEDS_PRICE_LIMIT', required — - `AVAILABLE`: Domain is available for registering - `AVAILABLE_FROM_ISSUER`: Domain is available for registering from an external issuer. - This status is deprecated as it is only relevant to subdomains that have a verified, self-custodied parent domain - `EXCEEDS_PRICE_LIMIT`: Domain is available for registering, but exceeds the price limit on your account. - In this situation you can contact your AM to facilitate a private sale or use our [Affiliate Program](https://unstoppabledomains.com/affiliate-registration) to refer users to our website for checkout - `REGISTERED`: Domain belongs to an owner and is not available for registering - `PROTECTED`: Domain is being protected by Unstoppable Domains and is not available for general registering - `RESERVED`: Domain is being reserved by Unstoppable Domains and is not available for general registering - `COMING_SOON`: Domain is temporarily unavailable but will be available in the future - `DISALLOWED`: Domain is currently not allowed to be registered
      - `price` DomainPriceResponse
        - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required — - `STANDARD`: Domain is priced using the default, standard pricing algorithm - `PREMIUM`: Domain is considered premium by the registry and pricing may differ from the standard pricing - `DEFERRED`: Domain pricing is not available and an additional request is needed to determine pricing. - This can be a limitation of the bulk domain searches due to constraints with checking prices for some registries - When requesting a single domain the price will always be included (if available) and this status will not be returned
        - `listPrice` DomainPriceItemResponse, required
          - `usdCents` number, required
        - `subTotal` DomainPriceItemResponse, required
          - `usdCents` number, required
      - `issuer` DomainOwnerResponse
        - `type` 'NONE' | 'UD' | 'SELF' | 'EXTERNAL', required — - `NONE`: Domain is not currently owned by anyone - `UD`: Domain is owned by a wallet/contract that belongs to Unstoppable Domains - `SELF`: Domain is owned by your account. You can manage this domains through the API - `EXTERNAL`: Owner doesn't qualify as any of the above.
        - `address` string
    - `registration` DomainRegistrationResponse
      - `tokenId` string, required
      - `tokenType` 'ERC721' | 'ERC1155'
    - `records` DomainRecords
  - `next` CursorListResponseNext, required
    - `$cursor` string, nullable, required

---

[API](https://skmtc.net/unstoppabledomains/apis/web3-partner-api-v3.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/web3-partner-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/web3-partner-api-v3/revisions/8331236de8e8/schema)