# Consultar proxy

Fonte: https://apiwpp.com/docs/api/conexoes/consultar-proxy
Seção: Conexões
Atualizado em: 2026-09-28

`GET /connections/{id}/proxy`

O proxy próprio da conexão, pelo qual saem o socket do WhatsApp e os uploads e downloads de mídia dela, sem as credenciais, e onde a última verificação o viu sair. Escopo necessário: `connections:read`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string · uuid` | sim | Identificador da conexão (o número). |

## Exemplo de requisição

### cURL

```bash
curl https://api.apiwpp.com/connections/$CONNECTION_ID/proxy \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/connections/${connectionId}/proxy`, {
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->get("https://api.apiwpp.com/connections/{$connectionId}/proxy");
```

### Python

```python
import requests

response = requests.get(
    f"https://api.apiwpp.com/connections/{connection_id}/proxy",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | O proxy da conexão (`proxy`), ou `{"proxy": null}` quando ela não tem proxy próprio. |
| 400 | `FST_ERR_VALIDATION` | A requisição não segue o schema da operação (por exemplo, um `id` que não é um UUID); `message` diz o que está errado. |
| 401 |  | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. O corpo é `{"error": "Unauthorized"}`. |
| 403 |  | A chave não tem o escopo `connections:read`; a mensagem de erro cita o escopo que falta. |
| 404 |  | A conexão não existe ou não é de quem chama: a de outra pessoa responde exatamente como uma que não existe (`Connection not found`). |
| 429 |  | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de `Retry-After`. Cabeçalhos: `Retry-After`. |
| 500 |  | O proxy gravado não pode ser aberto (as credenciais guardadas não abrem com a chave de criptografia do gateway); quem opera o gateway precisa corrigir. |

### 200 OK

```json
{
  "proxy": {
    "scheme": "socks5",
    "host": "br.proxy.example.com",
    "port": 1080,
    "hasCredentials": true,
    "country": "BR",
    "exit": {
      "ip": "203.0.113.7",
      "country": "BR",
      "checkedAt": "2026-09-24T12:00:00.000Z"
    }
  }
}
```

## Detalhes

`proxy` traz `scheme`, `host`, `port`, `hasCredentials` (se a URL tem usuário e senha) e `country` (o país exigido na verificação antes do pareamento; `null`: qualquer um). A URL e as credenciais nunca voltam. `proxy` é `null` quando a conexão não tem proxy próprio.

`exit` é onde a última verificação pelo proxy o viu sair: `ip` (o IP em que o WhatsApp vê o número), `country` (ISO 3166-1 alfa-2, ou `null` quando o serviço de IP não informa) e `checkedAt`.

Guia: [Proxy e IP dedicado](https://apiwpp.com/docs/guias/proxy-e-ip-dedicado).
