# Lookup multiple domain details and availability

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.

Endpoint: GET /domains
Version: 3.0.0
Security: bearer

## Query parameters:

  - `$expand` (array)
    Use $expand options to conditionally include portions of the response
    Enum: "records", "registration"

  - `ending` (array)
    TLD or Parent Domain to apply to your query base names

  - `query` (array, required)

  - `tlds` (array)
    Use ending instead
    Example: ["crypto"]

## Response 200 fields (application/json):

  - `@type` (string, required)
    Enum: "unstoppabledomains.com/partner.v3.List"

  - `items` (array, required)

  - `items.records` (any)

  - `items.name` (string, required)

  - `items.owner` (object, required)

  - `items.owner.type` (string, 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.
    Enum: "NONE", "UD", "SELF", "EXTERNAL"

  - `items.owner.address` (any)

  - `items.availability` (object, required)

  - `items.availability.status` (string, 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
    Enum: "AVAILABLE", "AVAILABLE_FROM_ISSUER", "REGISTERED", "PROTECTED", "COMING_SOON", "DISALLOWED", "RESERVED", "EXCEEDS_PRICE_LIMIT"

  - `items.availability.price` (object)

  - `items.availability.price.type` (string, 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
    Enum: "STANDARD", "PREMIUM", "DEFERRED"

  - `items.availability.price.listPrice` (object, required)

  - `items.availability.price.listPrice.usdCents` (number, required)
    Example: 1000

  - `items.availability.price.subTotal` (object, required)

  - `items.availability.issuer` (object)

  - `items.registration` (any)

  - `items.blockchain` (string)
    Enum: "MATIC", "ETH", "BASE"