domainmcp
Use the API Add the MCP
SearchCheck a name across every endingDomain pricesFirst year and renewal, every endingMCP setupClaude, ChatGPT and Gemini in a minuteAPIOpen REST endpoints, no key neededDocumentationEvery endpoint, tool and limit
Use the APIAdd the MCP

Documentation / Guides / Reading a result

Domain availability result fields

Reading a result

Every endpoint answers with the same kind of result for a domain. This page explains each field, how a free answer gets confirmed, and what to do with an unknown one.

The three answers

availableavailable: true
Nobody holds it: it can be registered now. It comes with price and buy_url, unless it is premium.
takenavailable: false
Somebody holds it. It comes with registrar, registered and expires when the registry publishes them.
unknownavailable: null
Not known yet: the registry did not answer in time, or the ending does not say. Ask again in a minute.

How sure an answer is

Answers are made fast first and then made sure. A name with no nameservers is very likely free, so that comes back straight away; the registry itself is then asked, usually within a minute. confirmed says whether that has happened, and by says where the answer came from.

registryconfirmed
The registry that runs the ending answered. This is the final word.
registrarconfirmed
For endings whose registry does not answer lookups, a registrar's own check answered.
dnsconfirmed
A taken name: its nameservers are live, so somebody holds it.
confirmingnot yet
Free by DNS and being confirmed with the registry. Ask again in a minute.
dns_onlynot yet
Free by DNS on an ending whose registry does not answer lookups. A registrar check is queued.

When an answer holds names still being confirmed, meta.confirming counts them and meta.note says so in words.

Free names

premiumboolean
True when the registry has set its own price for this name, often in the hundreds or more. Premium names have no price and no buy_url here.
priceobject
first_year, renews, min_years, on_offer and currency. See Prices and endings.
buy_urlstring
A short link that opens a registrar with the name ready to register. See Buy links.

Taken names

registrarstring or null
Who holds it.
registeredstring or null
The date it was first registered.
expiresstring or null
The date it is paid up to. A name past this date is not free until the registry releases it.

Some registries do not publish these, and some answers come from DNS alone, so any of them can be null. /v1/details asks the registry again for a taken name and adds its nameservers.

The rest of meta

countinteger
How many results are in data.
took_msinteger
How long the answer took on our side.
skippedlist
Inputs that could not be checked, each with input and error. See Errors.
PreviousQuick start