Skip to content
regfish Docs

Domain availability via RDAP

GET /api/v1/availability/{domain}

Non-binding availability check via public RDAP. Important: TLDs without public RDAP (for example .de) return state “unknown” together with noRdapForTld=true; only the responsible registry decides at registration time.

Path parameters

Section titled “Path parameters”
Name Type Required Description
domain string yes —

Responses

Section titled “Responses”
Status Type Description
200 AvailabilityResult Availability result
400 object Error
429 object Error

Response body

Section titled “Response body”
Field Type Required Description
api string no —
domain string no —
state string no (registered, available, unknown)
noRdapForTld boolean no true when the TLD offers no public RDAP (for example .de); state is then “unknown”
registrar string | null no —
created string | null no —
expires string | null no —
disclaimer string no —

Example

Section titled “Example”
Terminal-Fenster
curl -X GET "https://dns-doctor.com/api/v1/availability/<domain>" \
  -H "Authorization: Bearer $REGFISH_API_KEY"

Build a request

Section titled “Build a request”

Fill in values — the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.