---
title: "Suggest domain names"
method: GET
path: "/api/v1/inboxes/domains/suggest"
tags: ["Mailboxes"]
---

# Suggest domain names

`GET /api/v1/inboxes/domains/suggest`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/inboxes/domains/suggest`
- Auth: HTTP bearer

Free domain names for new sending mailboxes, made from your website or brand, each with its first-year and yearly renewal price in cents. Checks only; nothing is reserved or charged.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:manage_lists` |

## Query parameters

- `company` string, required
- `ending` string
- `limit` integer

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `company` string
  - `endings` string[]
  - `results` object[]
    - `name` string
    - `available` boolean
    - `first_year` object
      - `usd` integer
      - `eur` integer
    - `renewal` object
      - `usd` integer
      - `eur` integer

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:manage_lists.
- `422`: 422 Validation error. `validation_error` when a field has the wrong type or is missing.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)