Check domain availability | regfish DNS & TLS API

GET

/domains/availability/{domain}

Domains

Authentifizierung

x-api-key

SchnellstartAuthentifizierung Regfish ConsoleAPI-Key im Regfish-Interface anlegen und testen

Parameter

Name

Typ

Format

Pflicht

Description

domain

path

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

application/jsondomainAvailabilityResponse

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

application/jsonError

Response-Beispiel 400

{
  "success": false,
  "message": "Not a valid registrable domain name",
  "error": "Not a valid registrable domain name"
}

401

Unauthorized

application/jsonError

Response-Beispiel 401

{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

429

Too many availability checks

application/jsonError

Response-Beispiel 429

{
  "success": false,
  "message": "Too many availability checks",
  "error": "Too many availability checks"
}

500

Unexpected error

application/jsonError

Response-Beispiel 500

{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}

502

Availability could not be determined

application/jsonError

Response-Beispiel 502

{
  "success": false,
  "message": "Availability could not be determined",
  "error": "Availability could not be determined"
}

Verwandte Modelle

baseResult

domainAvailabilityResponse

Error

fqdn_relaxed

Fully Qualified Domain Name.

Werde 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. Werde Teil der Community und profitiere von den Vorteilen der DNS-Automatisierung. Das DNS API steht jedem Regfish-Kunden kostenlos zur Verfügung.