---
title: "Suggest alternative domains"
method: POST
path: "/domains/alternative-domains"
tags: ["Domains"]
---

# Suggest alternative domains

`POST /domains/alternative-domains`

## Request

- Base URL: `https://api.mailforge.ai/public`
- URL: `https://api.mailforge.ai/public/domains/alternative-domains`
- Auth: API key in header `Authorization`

Proposes up to `count` available alternative domain names for the given SLD and TLD. Does not create or reserve domains. Excludes domains already active on the account.

## Request body

- ApiSuggestAlternativeDomainsRequest
  - `count` integer
  - `inputSld` string
  - `outputTld` string

## Response `200`

OK

- MailforgeExternalApiDeliveryApiDomainAvailabilityResponse[]
  - `available` boolean
  - `domain` string
  - `price` number

## Other responses

- `400`: Invalid request or unsupported TLD

---

[API](https://skmtc.dev/mailforge/apis/mailforge-api.md) - [All operations](https://skmtc.dev/mailforge/apis/mailforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailforge/apis/mailforge-api/revisions/7d2c137f9fc3?raw)