> ## 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 /country-info/:code

> Recupere dados abrangentes de países por código ISO ou nome.

## Endpoint

```
GET https://api.bunny.build/api/v1/country-info/:code
```

Também suporta busca por nome:

```
GET https://api.bunny.build/api/v1/country-info?search=termo
```

## Autenticação

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

## Visão geral

Recupere dados estruturados de países usando um código ISO 3166-1 alfa-2 (ex: `BR`), alfa-3 (ex: `BRA`) ou uma consulta de busca por nome. A resposta cobre geografia, demografia, moedas, idiomas, códigos de discagem e mais em uma única chamada.

## Casos de uso

* Preencher campos de país e validar entradas em formulários de cadastro
* Enriquecer registros de endereços com dados de região, capital e código de discagem
* Alimentar calculadoras de frete com área, fronteiras e informações de fuso horário
* Orientar lógica de localização com base em idiomas, moedas e TLDs

## Requisição

Passe o código ISO 3166-1 alfa-2 ou alfa-3 como parâmetro de rota, ou use o parâmetro de consulta `search` para busca por nome.

**Exemplos:**

```
GET /country-info/BR
GET /country-info/BRA
GET /country-info?search=brazil
```

## Resposta

### 200 OK

| Campo           | Tipo             | Descrição                                     |
| --------------- | ---------------- | --------------------------------------------- |
| `cca2`          | string           | Código ISO 3166-1 alfa-2                      |
| `cca3`          | string           | Código ISO 3166-1 alfa-3                      |
| `name`          | string           | Nome comum do país                            |
| `official_name` | string           | Nome oficial do país                          |
| `capital`       | string           | Capital                                       |
| `region`        | string           | Região geográfica                             |
| `subregion`     | string           | Sub-região geográfica                         |
| `population`    | integer          | População estimada                            |
| `area_km2`      | number           | Área em quilômetros quadrados                 |
| `flag`          | string           | Emoji da bandeira                             |
| `currencies`    | array de objetos | Lista de moedas com `code`, `name` e `symbol` |
| `languages`     | array de strings | Idiomas oficiais                              |
| `calling_code`  | string           | Código de discagem internacional              |
| `tld`           | string           | Domínio de nível superior                     |
| `borders`       | array de strings | Códigos dos países vizinhos (alfa-3)          |
| `timezones`     | array de strings | Identificadores IANA de fuso horário          |
| `continents`    | array de strings | Continente(s)                                 |

**Exemplo**

```json theme={null}
{
  "cca2": "BR",
  "cca3": "BRA",
  "name": "Brazil",
  "official_name": "Federative Republic of Brazil",
  "capital": "Brasilia",
  "region": "Americas",
  "subregion": "South America",
  "population": 215313498,
  "area_km2": 8515767,
  "flag": "🇧🇷",
  "currencies": [{ "code": "BRL", "name": "Brazilian real", "symbol": "R$" }],
  "languages": ["Portuguese"],
  "calling_code": "+55",
  "tld": ".br",
  "borders": ["ARG", "BOL", "COL", "GUY", "PRY", "PER", "SUR", "URY", "VEN"],
  "timezones": ["America/Sao_Paulo", "America/Manaus"],
  "continents": ["South America"]
}
```

### 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

```json theme={null}
{
  "detail": "Country not found for the provided code or search term."
}
```

### 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/country-info/BR" \
  -H "X-API-Key: bun_your_api_key"
```