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

> Retorna os dados completos de uma empresa, incluindo contatos e negócios vinculados.

## Endpoint

```
GET /v1/companies/:id
```

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

## Exemplo de requisição

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

## Exemplo de resposta

```json theme={null}
{
  "data": {
    "id": "664b1c2d3e4f5a6789012346",
    "name": "Empresa ABC Ltda",
    "email": "contato@empresaabc.com.br",
    "phone": "+5511333344445",
    "website": "https://empresaabc.com.br",
    "sector": "Tecnologia",
    "size": "51-200",
    "city": "São Paulo",
    "state": "SP",
    "assigned_to": {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Maria Santos"
    },
    "tags": ["parceiro"],
    "custom_fields": {},
    "contacts_count": 8,
    "deals_count": 3,
    "total_deals_value": 45000,
    "contacts": [
      {
        "id": "664f1a2b3c4d5e6f78901234",
        "name": "João Silva",
        "email": "joao@empresaabc.com.br",
        "phone": "+5511999999999"
      }
    ],
    "deals": [
      {
        "id": "664c1d2e3f4a5b6789012347",
        "title": "Renovação Anual",
        "value": 24000,
        "status": "open",
        "stage": "Proposta enviada"
      }
    ],
    "created_at": "2026-01-10T09:00:00.000Z",
    "updated_at": "2026-05-20T11:30:00.000Z"
  }
}
```

## Campos adicionais (somente no GET por ID)

| Campo      | Tipo  | Descrição                                                                  |
| ---------- | ----- | -------------------------------------------------------------------------- |
| `contacts` | array | Contatos vinculados (até 50) com `id`, `name`, `email`, `phone`            |
| `deals`    | array | Negócios vinculados (até 50) com `id`, `title`, `value`, `status`, `stage` |