> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /domain-availability/:domain

> Verifique se um domínio está disponível para registro. Retorna status, registrador, data de registro, validade e flags de status ICANN.

## Endpoint

```
GET https://api.bunny.build/api/v1/domain-availability/:domain
```

## Autenticação

| Header      | Obrigatório | Valor                        |
| ----------- | ----------- | ---------------------------- |
| `X-API-Key` | Sim         | Sua chave de API (`bun_...`) |

## Visão geral

Verifique se um domínio está disponível para registro ou já foi registrado. A Bunny retorna o status de disponibilidade, registrador atual, data de registro, data de expiração e flags de status, tudo em uma única chamada de API.

## Casos de uso

* Ferramentas de busca e sugestão de domínios
* Monitorar registros de domínios de concorrentes
* Validar nomes de domínio fornecidos por usuários
* Criar integrações com marketplaces de domínios

## Detalhes

Suporta qualquer TLD público. Retorna `available: true` se nenhum registro for encontrado. O array `status` contém códigos de status EPP padrão ICANN (ex.: `clientTransferProhibited`).

## Parâmetros de rota

| Parâmetro | Tipo   | Obrigatório | Descrição                                |
| --------- | ------ | ----------- | ---------------------------------------- |
| `domain`  | string | Sim         | Domínio a verificar (ex.: `example.com`) |

## Resposta

### 200 OK

| Campo       | Tipo    | Descrição                                         |
| ----------- | ------- | ------------------------------------------------- |
| `domain`    | string  | O domínio verificado                              |
| `available` | boolean | `true` se o domínio está disponível para registro |
| `tld`       | string  | Extensão do domínio (ex.: `com`)                  |

**Exemplo**

```json theme={null}
{
  "domain": "example.com",
  "available": false,
  "tld": "com"
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

Formato de domínio inválido.

```json theme={null}
{
  "detail": "Invalid domain format"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
curl https://api.bunny.build/api/v1/domain-availability/example.com \
  -H "X-API-Key: bun_sua_chave_api"
```