DNS API-Referenz
v1.6.2
Check domain availability
Check whether a domain is still registrable. Answered from the regfish lookup service (RDAP/WHOIS against the registries), the same source that powers the domain search on regfish.de, not the account database. This endpoint deliberately works on any domain, not just the ones in the account: the whole point is to ask about domains nobody owns yet. A check that cannot be completed (registry unreachable, timeout) returns
502 rather than reporting the domain as taken, guessing here would cost the customer a registration. Rate limit: 60 checks per minute and API key, and 120 checks per minute and account. The account limit applies across all of your API keys and OAuth clients, so issuing another credential does not raise it.GET
/domains/availability/{domain}
Domains
Authentifizierung
Parameter
Name
Typ
Format
Pflicht
Description
domain
string
-
Pflicht
A domain name to check. Unlike `fqdn_relaxed` this also accepts internationalised names (e.g. `müller-shop.de`); they are converted to punycode and validated against the public suffix list server-side.
Request-Beispiel
GET
curl --request GET \
--url 'https://api.regfish.com/domains/availability/example.de' \
--header 'x-api-key: YOUR_API_KEY'Responses
200
Availability result
Response-Beispiel 200
{
"success": true,
"code": 0,
"response": {
"domain": "example",
"sld": "example",
"tld": "example",
"available": true,
"status": "available",
"flags": [
"example"
]
}
}400
Not a valid registrable domain name
Response-Beispiel 400
{
"success": false,
"message": "Not a valid registrable domain name",
"error": "Not a valid registrable domain name"
}401
Unauthorized
Response-Beispiel 401
{
"success": false,
"message": "Unauthorized",
"error": "Unauthorized"
}429
Too many availability checks
Response-Beispiel 429
{
"success": false,
"message": "Too many availability checks",
"error": "Too many availability checks"
}500
Unexpected error
Response-Beispiel 500
{
"success": false,
"message": "Unexpected error",
"error": "Unexpected error"
}502
Availability could not be determined
Response-Beispiel 502
{
"success": false,
"message": "Availability could not be determined",
"error": "Availability could not be determined"
}Community
Werden Sie ein Teil der Community
Das DNS API von regfish ist die perfekte Lösung für Entwickler, die ihre Domains und DNS-Zonen automatisieren möchten. Werden Sie Teil der Community und profitieren Sie von den Vorteilen der DNS-Automatisierung. Das DNS API steht jedem regfish-Kunden kostenlos zur Verfügung.