---
title: "Lookup multiple domains"
method: GET
path: "/domains"
tags: ["domain-search"]
---

# Lookup multiple domains

`GET /domains`

Get domain availability and details for multiple domains. Optionally, use the `$expand` query parameter to include additional data in the response (e.g. `?$expand=registration&$expand=flags`).

If a domain is available for registration it will have an `availability.status` of `AVAILABLE` and will include an `availability.price` object.

**Search constraints:**
- Each `query` value must be a fully qualified domain name (e.g. `example.com`), OR at least one `ending` parameter must be provided.
- The total number of domains resolved (queries × endings) must not exceed **50**.
- If a `query` value already contains a valid TLD (e.g. `example.com`), it is looked up directly and is not combined with `ending` values.

## Query parameters

- `$expand` DomainExpandField[]
- `ending` string[]
- `query` string[], required

## Response `200`

List of domains matching search query

- MultipleDomainSearchResponse
  - `@type` 'unstoppabledomains.com/partner.v3.List', required
  - `items` DomainSearchResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.Domain', required
    - `name` string, required
    - `owner` DomainOwnerResponse, required
      - `type` 'NONE' | 'UD' | 'UNKNOWN', required
      - `contactId` string
    - `availability` SingleDomainAvailabilityResponse, required
      - `source` 'UD' | 'SEDO' | 'AFTERNIC', required
      - `status` 'AVAILABLE' | 'AVAILABLE_BACKORDER' | 'REGISTERED' | 'PROTECTED' | 'COMING_SOON' | 'DISALLOWED' | 'RESERVED' | 'AVAILABLE_FROM_ISSUER' | 'AVAILABLE_FROM_SELLER' | 'EXCEEDS_PRICE_LIMIT' | 'REGISTRATION_PENDING' | 'UNKNOWN_MAINTENANCE', required
      - `issuer` DomainOwnerResponse
        - `type` 'NONE' | 'UD' | 'UNKNOWN', required
        - `contactId` string
      - `price` DomainPriceResponse
        - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
        - `listPrice` PriceItemResponse, required
          - `usdCents` number, required
        - `adjustments` DomainPriceAdjustmentResponse[]
          - `usdCents` number, required
          - `type` string, required
        - `subTotal` PriceItemResponse, required
          - `usdCents` number, required
        - `validUntilTimestamp` number
      - `offer` DomainOfferPriceResponse
        - `min` DomainPriceResponse, required
          - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
          - `listPrice` PriceItemResponse, required
            - `usdCents` number, required
          - `adjustments` DomainPriceAdjustmentResponse[]
            - `usdCents` number, required
            - `type` string, required
          - `subTotal` PriceItemResponse, required
            - `usdCents` number, required
          - `validUntilTimestamp` number
      - `additionalPricing` DomainAvailabilityAdditionalPricingResponse
        - `extendedRegistration` DomainPriceResponse
          - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
          - `listPrice` PriceItemResponse, required
            - `usdCents` number, required
          - `adjustments` DomainPriceAdjustmentResponse[]
            - `usdCents` number, required
            - `type` string, required
          - `subTotal` PriceItemResponse, required
            - `usdCents` number, required
          - `validUntilTimestamp` number
        - `transfer` DomainPriceResponse
          - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
          - `listPrice` PriceItemResponse, required
            - `usdCents` number, required
          - `adjustments` DomainPriceAdjustmentResponse[]
            - `usdCents` number, required
            - `type` string, required
          - `subTotal` PriceItemResponse, required
            - `usdCents` number, required
          - `validUntilTimestamp` number
      - `constraints` DomainAvailabilityConstraintsResponse
        - `registration` DomainAvailabilityRegistrationConstraintsResponse
          - `period` IcannDomainRenewalInfoPeriodResponse, required
            - `min` number, required
            - `max` number, required
            - `increments` number, required
      - `availableAfterTimestamp` number
    - `registration` DomainRegistrationResponse
      - `status` 'REGISTERED' | 'REGISTERED_EXTERNAL' | 'PENDING' | 'EXPIRED_GRACE_PERIOD' | 'EXPIRED_REDEMPTION_PERIOD' | 'EXPIRED_PENDING_DELETE' | 'INACTIVE'
      - `tokenId` string
      - `tokenType` 'ERC721' | 'ERC1155' | 'ENSRecord' | 'TOKEN2022'
      - `pricing` DomainPostRegistrationPricingResponse
        - `renewal` DomainPriceResponse
          - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
          - `listPrice` PriceItemResponse, required
            - `usdCents` number, required
          - `adjustments` DomainPriceAdjustmentResponse[]
            - `usdCents` number, required
            - `type` string, required
          - `subTotal` PriceItemResponse, required
            - `usdCents` number, required
          - `validUntilTimestamp` number
      - `registryCreatedDate` string
      - `expirationDate` string
      - `expirationGracePeriodDate` string
      - `deletionAtTimestamp` number
      - `icann` DomainRegistrationIcannResponse
        - `registrar` DomainRegistrationIcannRegistrarResponse, required
          - `type` 'SELF' | 'EXTERNAL' | 'NONE', required
        - `ownershipVerification` 'COMPLETED' | 'REVERIFICATION_REQUIRED'
    - `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

## Other responses

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

---

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