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

# Buscar contato

> Retorna os dados completos de um contato, incluindo negócios vinculados.

## Endpoint

```
GET /v1/contacts/:id
```

**Escopo necessário:** `read:contacts`

## Parâmetros de path

| Parâmetro | Tipo   | Descrição     |
| --------- | ------ | ------------- |
| `id`      | string | ID do contato |

## Exemplo de requisição

```bash theme={null}
curl "https://api.socialsell.ai/v1/contacts/664f1a2b3c4d5e6f78901234" \
  -H "Authorization: Bearer sk_live_..."
```

## Exemplo de resposta

```json theme={null}
{
  "data": {
    "id": "664f1a2b3c4d5e6f78901234",
    "name": "João Silva",
    "email": "joao@empresa.com.br",
    "phone": "+5511999999999",
    "instagram_username": "joaosilva",
    "whatsapp_jid": "5511999999999@s.whatsapp.net",
    "messenger_psid": null,
    "messenger_name": null,
    "source": "whatsapp",
    "avatar_url": null,
    "assigned_to": {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Maria Santos"
    },
    "company": {
      "id": "664b1c2d3e4f5a6789012346",
      "name": "Empresa ABC"
    },
    "tags": ["cliente", "vip"],
    "custom_fields": {},
    "funnel_stage": null,
    "notes_count": 2,
    "deals_count": 1,
    "messages_count": 47,
    "last_message_at": "2026-06-01T14:22:00.000Z",
    "deals": [
      {
        "id": "664c1d2e3f4a5b6789012347",
        "title": "Proposta Enterprise",
        "value": 15000,
        "status": "open",
        "stage": "Proposta enviada"
      }
    ],
    "created_at": "2026-01-15T10:30:00.000Z",
    "updated_at": "2026-06-01T14:22:00.000Z"
  },
  "meta": {
    "request_id": "req_01jx8kz3m4n5p6q7r8s9t0u1v"
  }
}
```

## Campos adicionais (somente no GET por ID)

| Campo            | Tipo    | Descrição                                                                  |
| ---------------- | ------- | -------------------------------------------------------------------------- |
| `messages_count` | integer | Total de mensagens trocadas                                                |
| `deals`          | array   | Negócios vinculados (até 10) com `id`, `title`, `value`, `status`, `stage` |

## Erros

| Código       | Status | Descrição                             |
| ------------ | ------ | ------------------------------------- |
| `INVALID_ID` | `400`  | ID com formato inválido               |
| `NOT_FOUND`  | `404`  | Contato não encontrado na organização |