---
title: "Lookup a single domain"
method: GET
path: "/domains/{name}"
tags: ["domain-search"]
---

# Lookup a single domain

`GET /domains/{name}`

Get availability and details for a single domain. Optionally, use the `$expand` query parameter to include additional data such as registration details and flags.

## Path parameters

- `name` string, required

## Query parameters

- `$expand` DomainExpandField[]

## Response `200`

Domain details

- DomainSearchResponse
  - `@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
- `404` — Resource not found
- `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)