---
title: Domain Availability API - Check Domain Names in Real Time and Get Suggestions
version: 1.0.0
description: Check whether a domain is available for registration across all top-level domains (TLDs) and second-level domains (SLDs). Uses DNS-based or WHOIS-based lookups to determine domain availability. Returns a simple response with the domain name and a boolean availability indicator.
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 2
---

## Table of Contents

- [Domain Availability API - Check Domain Names in Real Time and Get Suggestions v1.0.0](#domain-availability-api-check-domain-names-in-real-time-and-get-suggestions-v100)
  - [Authentication](#authentication)
  - [Domain APIs](#domain-apis)
    - [checkDomainAvailability](#checkdomainavailability)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [DomainAvailabilityResponse](#domainavailabilityresponse)
    - [ErrorResponse](#errorresponse)



# Domain Availability API - Check Domain Names in Real Time and Get Suggestions v1.0.0

Check whether a domain is available for registration across all top-level domains (TLDs) and second-level domains (SLDs). Uses DNS-based or WHOIS-based lookups to determine domain availability. Returns a simple response with the domain name and a boolean availability indicator.

Base URLs:

* [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## Domain APIs

### checkDomainAvailability

`GET /domain/availability`

*Check whether a domain is available for registration or not.*

The Domain Search API is designed to simplify the process of finding available domain names across all top-level domains (TLDs) and second-level domains (SLDs).

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Format of the response.|
|domain|query|string|true|Domain name whose availability is to be checked.|
|source|query|string|false|Specify the data source for domain availability checks. Use "dns" for DNS-based lookups or "whois" for WHOIS-based lookups. By default, "dns" is used.|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|
|source|dns|
|source|whois|

> Example responses

> Success

```json
{
  "domain": "google.com",
  "domainAvailability": false
}
```

> Bad Request – Missing domain, or domain has an unrecognized/unsupported TLD

```json
{
  "error": "Invalid Param Exception",
  "message": "please pass correct parameters",
  "path": "/v1.0/domain/availability",
  "status": 400,
  "timestamp": "2026-07-27T12:18:21.115Z"
}
```

```json
{
  "timestamp": "2026-07-27T12:18:47.346748812Z",
  "status": 400,
  "error": "Invalid Param Exception",
  "message": "Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]",
  "path": "/v1.0/domain/availability"
}
```

> Request Timeout – Unable to fetch WHOIS data

```json
{
  "timestamp": "2025-08-14T10:37:21.871Z",
  "status": 408,
  "error": "Request Timeout",
  "message": "Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]",
  "path": "/v1.0/domain/availability"
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Success|[DomainAvailabilityResponse](#domainavailabilityresponse)|
|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|Bad Request – Missing domain, or domain has an unrecognized/unsupported TLD|[ErrorResponse](#errorresponse)|
|408|[Request Timeout](https://tools.ietf.org/html/rfc7231#section-6.5.7)|Request Timeout – Unable to fetch WHOIS data|[ErrorResponse](#errorresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|
|400|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|
|408|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### DomainAvailabilityResponse

Domain availability check response containing the domain name and availability status.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|domain|string|true|none|Name of the queried domain|
|domainAvailability|boolean|true|none|True if available, false if not available|

### ErrorResponse

Standard error envelope returned by the API on failed requests.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|error|string|false|none|Short error category or exception type.|
|message|string|true|none|Human-readable error message describing the failure.|
|path|string|false|none|API endpoint path that produced the error.|
|status|integer|false|none|HTTP status code returned with the error.|
|timestamp|string(date-time)|false|none|Timestamp when the error occurred (ISO 8601).|