---
title: "Bulk domain check"
method: POST
path: "/domains/check"
---

# Bulk domain check

`POST /domains/check`

## Request

- Base URL: `https://namemy.app/api/v1`
- URL: `https://namemy.app/api/v1/domains/check`
- Auth: HTTP bearer

Check up to 100 domains at once. Each `available` entry has the same
shape as the single check. Domains we could not price are listed in
`errors` with code `quote_unavailable`; if none could be priced the
whole request returns 503.

## Request body

- object
  - `domains` string[], required: List of domains to check

## Response `200`

Bulk availability results

- object
  - `checked` integer
  - `available` DomainCheckResult[]
    - `domain` string, required
    - `available` boolean, required
    - `isPremium` boolean: Present and true for premium-tier domains; still purchasable at `retailPrice`
    - `bestPrice` BestPrice, required
      - `registrar` 'namemy.app', required: Always namemy.app, the registrar of record you pay
      - `retailPrice` number, required: First-year price charged, in `currency`
      - `retailRenewal` number, required: Yearly renewal price
      - `currency` string, required
    - `buyUrl` string, required: One-click checkout link; `null` when the domain is taken. Normally a short `/buy/<token>` link; falls back to a `/checkout?...` link.
    - `proposalToken` string: Token in the short buyUrl
    - `expiresAt` string, date-time: When the short buyUrl's held price expires
  - `unavailable` string[]: Domains that are already registered
  - `errors` object[]: Domains with no price quote right now
    - `domain` string
    - `code` 'quote_unavailable'
    - `error` string

## Other responses

- `400`: `invalid_domain`: no valid domains, or more than 100
- `401`: Missing or invalid API key
- `403`: Valid key but missing required permission
- `429`: Rate limit or daily quota exceeded
- `503`: `quote_unavailable`: no registrar price right now. Retry shortly.

---

[API](https://skmtc.dev/namemy/apis/namemy-app-api.md) · [All operations](https://skmtc.dev/namemy/apis/namemy-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namemy/apis/namemy-app-api/revisions/1c302ede4b63?raw)