---
title: "Get domain details and availability"
method: GET
path: "/domains/{name}"
tags: ["domain_registration"]
---

# Get domain details and availability

`GET /domains/{name}`

Get information about the domain's current owner and availability status. 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.

## Path parameters

- `name` string, required

## Query parameters

- `$expand` string[]

## Response `200`

- DomainSearchResponse
  - `@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)