# Lookup multiple domains

Get domain availability and details for multiple domains using the query string search options. 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.

Endpoint: GET /domains
Version: 1.0.0
Security: bearer

## Query parameters:

  - `$expand` (array)
    Enum: "registration", "flags"

  - `ending` (array, required)

  - `query` (array, required)

## Response 200 fields (application/json):

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

  - `items` (array, required)

  - `items.name` (string, required)

  - `items.owner` (object, required)

  - `items.owner.type` (string, required)
    Enum: "NONE", "UD", "UNKNOWN"

  - `items.owner.contactId` (string)

  - `items.availability` (object, required)

  - `items.availability.source` (string, required)
    Enum: "UD", "SEDO", "AFTERNIC"

  - `items.availability.status` (string, required)
    Enum: "AVAILABLE", "AVAILABLE_BACKORDER", "REGISTERED", "PROTECTED", "COMING_SOON", "DISALLOWED", "RESERVED", "AVAILABLE_FROM_ISSUER", "AVAILABLE_FROM_SELLER", "EXCEEDS_PRICE_LIMIT", "REGISTRATION_PENDING", "UNKNOWN_MAINTENANCE"

  - `items.availability.issuer` (object)

  - `items.availability.price` (object)

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

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

  - `items.availability.price.adjustments` (array)

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

  - `items.availability.price.validUntilTimestamp` (number)

  - `items.availability.offer` (object)

  - `items.availability.offer.min` (object, required)

  - `items.availability.additionalPricing` (object)

  - `items.availability.additionalPricing.extendedRegistration` (object)

  - `items.availability.additionalPricing.transfer` (object)

  - `items.availability.constraints` (object)

  - `items.availability.constraints.registration` (object)

  - `items.availability.constraints.registration.period` (object, required)

  - `items.availability.constraints.registration.period.max` (number, required)

  - `items.availability.constraints.registration.period.increments` (number, required)

  - `items.availability.availableAfterTimestamp` (number)

  - `items.flags` (object)

  - `items.flags.DNS_RESOLUTION` (object, required)

  - `items.flags.DNS_RESOLUTION.readonly` (object)

  - `items.flags.DNS_RESOLUTION.readonly.state` (boolean, required)

  - `items.flags.DNS_RESOLUTION.readonly.reasons` (array, required)

  - `items.flags.DNS_TRANSFER_OUT` (object, required)

  - `items.flags.DNS_DELETE` (object, required)

  - `items.flags.DNS_UPDATE` (object, required)

  - `items.flags.DNS_RENEW` (object, required)

  - `items.flags.DNS_WHOIS_PROXY` (object, required)