# Contato do Lead

> Retorna telefones e e-mails de um registro localizado pela consulta Leads por Endereço. Cobrado por registro consultado.

- **Consulta:** `leads-contato`
- **Categoria:** Comercial
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `POST https://app.fontedata.com/api/v1/consulta/leads-contato`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/comercial/leads-contato

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Retorna os dados de contato de um registro específico. O `id` vem do campo `id` de cada item da consulta **Leads por Endereço** — primeiro você lista quem está no endereço, depois pede o contato apenas de quem interessa. Use o `id` na sequência da busca: ele identifica o registro na base de origem e não é um identificador permanente.
>
> Cada chamada retorna **um registro** e é cobrada individualmente. Para obter o contato de dez registros, faça dez chamadas.

## Requisição

### cURL

```bash
curl -X POST -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/leads-contato?id=48282358"
```

### Python

```python
import requests

resp = requests.post(
    "https://app.fontedata.com/api/v1/consulta/leads-contato",
    params={"id": "48282358"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/leads-contato");

url.search = new URLSearchParams({
  "id": "48282358"
}).toString();

const resp = await fetch(url, {
  method: "POST",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `id` | texto | sim | Identificador do registro, obtido no campo `id` da consulta Leads por Endereço. | `48282358` |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - **`idConsultado`**: eco do identificador informado.
> - **`nome`**: **razão social completa** quando é empresa; nome **parcialmente mascarado** quando é pessoa física.
> - **`documento`**: **CNPJ completo** quando é empresa; **CPF parcialmente mascarado** quando é pessoa física.
> - **`tipoPessoa`**: `PF` ou `PJ`.
> - **`telefones[]`**: `ddd` e `numero` de cada telefone. O DDD é o do telefone e pode não corresponder à região do endereço.
> - **`emails[]`**: e-mails associados ao registro.
>
> Esta consulta **não devolve endereço**: o vínculo com o imóvel vem do filtro da consulta Leads por Endereço.
>
> Quando o registro não tem contato na base, a resposta vem com `consta: false` e **é cobrada normalmente** — a consulta foi executada na base de origem.

### Exemplo de resposta

```json
{
  "nome": "CONDOMINIO EDIFICIO EXEMPLO",
  "emails": [
    "contato@exemplo.com.br"
  ],
  "documento": "00000000000191",
  "telefones": [
    {
      "ddd": "11",
      "numero": "32555361"
    },
    {
      "ddd": "11",
      "numero": "30644576"
    },
    {
      "ddd": "11",
      "numero": "31672576"
    }
  ],
  "tipoPessoa": "PJ",
  "idConsultado": "48282358"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social completa quando o registro é empresa; nome parcialmente mascarado quando é pessoa física."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "E-mails associados ao registro."
    },
    "documento": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ completo quando o registro é empresa; CPF parcialmente mascarado quando é pessoa física."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "ddd": {
            "type": [
              "string",
              "integer",
              "null"
            ],
            "description": "DDD do telefone, sem o zero."
          },
          "numero": {
            "type": [
              "string",
              "integer",
              "null"
            ],
            "description": "Número do telefone, sem o DDD."
          }
        }
      },
      "x-display": "table",
      "description": "Telefones associados ao registro. O DDD é o do telefone e pode não corresponder à região do endereço — a pessoa ou empresa pode ter mantido um número de outra praça."
    },
    "tipoPessoa": {
      "type": [
        "string",
        "null"
      ],
      "description": "PF para pessoa física, PJ para empresa."
    },
    "idConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Eco do identificador informado na consulta."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Identificador inválido. Informe o `id` retornado pela consulta Leads por Endereço. | O identificador enviado não é numérico. |
| `402` | Saldo insuficiente para realizar a consulta. | A conta não tem saldo para cobrir o preço da consulta. |
| `504` | A consulta excedeu o tempo limite. Tente novamente. | A base de origem não respondeu dentro do tempo limite. |
| `503` | Serviço de consulta temporariamente indisponível. Tente novamente. | A base de origem não respondeu ou devolveu erro transitório. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Obter o telefone e o e-mail de um registro que você já localizou por endereço.
> - Falar com a administração de um condomínio: o próprio condomínio costuma aparecer como empresa, com razão social e CNPJ completos.
> - Montar uma lista de contatos a partir de um imóvel ou região, pagando apenas pelos registros escolhidos.

---

Página em HTML: https://fontedata.com/docs/comercial/leads-contato
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp