Check domain availability
GET /domains/availability/{domain}Operation ID: CheckDomainAvailability
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.com, 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.
Path parameters
Section titled “Path parameters”| Name | Type | Required | Description |
|---|---|---|---|
domain | domain_name_checkable | yes | - |
Responses
Section titled “Responses”| Status | Type | Description |
|---|---|---|
200 | domainAvailabilityResponse | Availability result |
400 | Error | Not a valid registrable domain name |
401 | Error | Unauthorized |
429 | Error | Too many availability checks |
500 | Error | Unexpected error |
502 | Error | Availability could not be determined |
Response body
Section titled “Response body”| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | yes | Success indicator |
code | integer | no | Response/Error Code |
response | domainAvailabilityResponse | no | - |
Example
Section titled “Example”curl -X GET "https://api.regfish.com/domains/availability/<domain>" \ -H "x-api-key: $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.