---
title: "Get suggested domains that are available for registering"
method: GET
path: "/suggestions/domains"
tags: ["suggestions"]
---

# Get suggested domains that are available for registering

`GET /suggestions/domains`

All domains returned by this route are available for registration

## Query parameters

- `tlds` string[]
- `ending` union[]
  - union
    - string
    - string
- `query` union[], required
  - union
    - string
    - string

## Response `200`

- SuggestionsResponse
  - `@type` 'unstoppabledomains.com/partner.v3.List', required
  - `items` SuggestionsResponseItem[], required
    - `@type` 'unstoppabledomains.com/partner.v3.DomainSuggestion', required
    - `name` string, required
    - `price` DomainPriceResponse, required
      - `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

## 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)