---
title: "Lookup multiple domain details and availability"
method: GET
path: "/domains"
tags: ["domain_registration"]
---

# Lookup multiple domain details and availability

`GET /domains`

Get domain availability and owner details for multiple domains using the query string search options. Optionally, use the `$expand` query string to include additional data in the response (ie. `?$expand=records&$expand=registration`).

If the domain is available to be registered it will have a `availability.status` of `AVAILABLE` and will include an `availability.price` object.

## Query parameters

- `$expand` string[] — Use `$expand` options to conditionally include portions of the response
- `tlds` string[]
- `ending` union[]
  - union
    - string
    - string
- `query` union[], required
  - union
    - string
    - string

## Response `200`

- MultipleDomainSearchResponse
  - `@type` 'unstoppabledomains.com/partner.v3.List', required
  - `items` DomainSearchResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.Domain', required
    - `records` DomainRecords
    - `name` string, required
    - `owner` DomainOwnerResponse, required
      - `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, required
      - `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'
    - `blockchain` 'MATIC' | 'ETH' | 'BASE'

## Other responses

- `400`

---

[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)