---
title: "Check a list of exact domains"
method: POST
path: "/dfy/domains/check"
tags: ["DoneForYou"]
---

# Check a list of exact domains

`POST /dfy/domains/check`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/dfy/domains/check`
- Auth: HTTP bearer

Checks up to 100 exact domains in one call, for a caller who already has the list. One answer per unique domain, in the order given, each following the single check's rules. A registrar failure on one name marks it unconfirmed rather than failing the list; the call fails only when nothing could be checked.

## Request body

- ModelsCheckDfyDomainsRequest
  - `domains` string[], required

## Response `200`

Availability of each domain

- ModelsCheckDfyDomainsResponse
  - `domains` ModelsCheckDfyDomainResponse[]
    - `available` boolean
    - `domain` string
    - `price` number
    - `reason` string: Reason says why the domain cannot be bought, in words that can be shown to a person. Empty when available is true.
    - `tld` string
    - `unconfirmed` boolean: Unconfirmed is true when we could not get an answer at all rather than the answer "no". Do not report these as taken; offer a retry.

## Other responses

- `400`: Empty list, or more than 100 domains
- `401`: Unauthorized - invalid or missing API key
- `502`: Domain search service unavailable

---

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