---
title: "Fast DNS-based domain existence check"
method: GET
path: "/api/domains/dns-check"
tags: ["Domain Search"]
---

# Fast DNS-based domain existence check

`GET /api/domains/dns-check`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/domains/dns-check`
- Auth: none required

Tests if a domain name is taken across many TLDs at once using DNS queries (faster than search, no pricing). Returns 'taken' (definitely registered) and 'candidates' (potentially available) arrays. Use this to narrow down before calling search for pricing. **Public endpoint** - no authentication required.

## Query parameters

- `name` string, required
- `tlds` string, required

## Response `200`

DNS check results

- object
  - `name` string
  - `taken` string[]: TLDs that are definitely registered
  - `candidates` string[]: TLDs that are potentially available

## Other responses

- `400`: Invalid request parameters
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)