> ## 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 /ip-lookup

> Obtenha geolocalização e dados de rede detalhados para qualquer IP: país, cidade, coordenadas, fuso horário, ISP, organização e ASN em uma requisição.

## Endpoint

```
GET https://api.bunny.build/api/v1/ip-lookup?ip=8.8.8.8
```

## Autenticação

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

## Visão geral

Obtenha informações detalhadas de geolocalização e rede para qualquer endereço IP. A Bunny retorna o país, região, cidade, coordenadas, fuso horário, nome do ISP, organização e ASN, tudo em uma única requisição rápida.

## Casos de uso

* Personalizar conteúdo e idioma pela localização do usuário
* Registrar a origem das requisições para análises e auditorias
* Aplicar controles de acesso baseados em região
* Exibir localizações estimadas de entrega

## Detalhes

Suporta IPv4 e IPv6. A precisão em nível de cidade varia por região e ISP. As coordenadas representam o centro aproximado da cidade detectada, não a localização exata do usuário final.

## Parâmetros de query

| Parâmetro | Tipo   | Obrigatório | Descrição                    |
| --------- | ------ | ----------- | ---------------------------- |
| `ip`      | string | Sim         | Endereço IPv4 ou IPv6 válido |

## Resposta

### 200 OK

| Campo      | Tipo           | Descrição                               |
| ---------- | -------------- | --------------------------------------- |
| `ip`       | string         | O IP consultado                         |
| `country`  | string \| null | Código do país ISO (ex.: `US`)          |
| `region`   | string \| null | Nome da região/estado                   |
| `city`     | string \| null | Nome da cidade                          |
| `lat`      | number \| null | Latitude                                |
| `lon`      | number \| null | Longitude                               |
| `timezone` | string \| null | Fuso horário (ex.: `America/Sao_Paulo`) |
| `asn`      | int \| null    | Número do Sistema Autônomo              |
| `org`      | string \| null | Nome da organização                     |

**Exemplo**

```json theme={null}
{
  "ip": "8.8.8.8",
  "country": "US",
  "region": "California",
  "city": "Mountain View",
  "lat": 37.386,
  "lon": -122.0838,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC"
}
```

### 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 IP inválido.

```json theme={null}
{
  "detail": "Invalid IP address 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/ip-lookup?ip=8.8.8.8" \
  -H "X-API-Key: bun_sua_chave_api"
```