# Listar Negócios do Pipeline

> Retorna a lista de negócios do pipeline de CRM da conta autenticada, com suporte a filtros e produtos vinculados.

`GET https://crm.wavups.com/api/v1/account-crm-pipeline-deal`

Página: https://crm.wavups.com/docs/api/negocios-pipeline/listar

## Requisição

`GET https://crm.wavups.com/api/v1/account-crm-pipeline-deal`

- `Token` (string, obrigatório, header):
  Seu token de autenticação.

### Query Parameters

- `stageId` (string, query):
  Filtra negócios pelo ID do estágio do pipeline.

- `leadId` (string, query):
  Filtra negócios pelo ID do lead vinculado.

- `dealOwner` (string, query):
  Filtra negócios pelo ID do usuário responsável.

---

## Resposta

Retorna um array de objetos de negócio. O campo `updatedAt` é omitido.

- `id` (string):
  Identificador único do negócio.

- `stageId` (string):
  ID do estágio em que o negócio se encontra.

- `leadId` (string | null):
  ID do lead vinculado ao negócio.

- `dealOwner` (string | null):
  ID do usuário responsável pelo negócio.

- `title` (string):
  Título do negócio.

- `description` (string | null):
  Descrição detalhada do negócio.

- `value` (number | null):
  Valor monetário do negócio.

- `status` (string):
  Status do negócio (ex: `open`, `won`, `lost`).

- `type` (string | null):
  Tipo ou categoria do negócio.

- `nextAction` (string | null):
  Próxima ação prevista para o negócio.

- `source` (string | null):
  Origem do negócio (ex: `site`, `indicacao`, `whatsapp`).

- `customFields` (object):
  Campos personalizados preenchidos do negócio, pela chave do campo (só os do pipeline do negócio). Seleção traz o **nome** da opção e seleção múltipla uma lista de nomes. Sem valores, vem `{}`.

- `probability` (number):
  Probabilidade de fechamento em percentual (0 a 100).

- `order` (number):
  Posição de ordenação do negócio na coluna do estágio.

- `expectedClose` (string | null):
  Data prevista de fechamento no formato ISO 8601.

- `wonAt` (string | null):
  Data e hora em que o negócio foi ganho (ISO 8601).

- `lostAt` (string | null):
  Data e hora em que o negócio foi perdido (ISO 8601).

- `currency` (string):
  Moeda do valor: código ISO 4217 de 3 letras (ex: `BRL`, `USD`, `EUR`). Negócio sem moeda gravada vem como `BRL`. O `value` está sempre nessa moeda.

- `lossReasonId` (string | null):
  Motivo da perda escolhido na plataforma (só em negócios perdidos).

- `lossNote` (string | null):
  Observação da perda (só em negócios perdidos).

- `createdAt` (string):
  Data e hora de criação do negócio (ISO 8601).

- `AccountCRMLead` (object | null):
  Dados simplificados do lead vinculado.
  Propriedades do Lead:
  - `id` (string):ID do lead.
  - `name` (string):Nome do lead.
  - `email` (string | null):E-mail do lead.
  - `phone` (string | null):Telefone do lead.
  

- `AccountUser` (object | null):
  Dados do usuário responsável pelo negócio.
  Propriedades do Responsável:
  - `id` (string):ID do vínculo do usuário na conta.
  - `User` (object):
  - `name` (string):Nome do usuário.
  - `email` (string):E-mail do usuário.
  
  

- `AccountCRMPipelineStage` (object):
  Dados do estágio do pipeline ao qual o negócio pertence.
  Propriedades do Estágio:
  - `id` (string):ID do estágio.
  - `name` (string):Nome do estágio.
  - `pipelineId` (string):ID do pipeline associado.
  

- `accountCRMPipelineDealProductAssignments` (array):
  Lista de produtos vinculados ao negócio.
  Propriedades do Vínculo de Produto:
  - `id` (string):Identificador único do vínculo.
  - `accountProductId` (string):ID do produto na conta.
  - `quantity` (number):Quantidade do produto.
  - `discount` (number | null):Valor ou percentual de desconto aplicado.
  - `discountType` (string | null):Tipo do desconto (`PERCENTAGE` ou `FIXED`).
  - `totalPrice` (number | null):Preço total calculado após aplicação de quantidade e descontos.
  - `createdAt` (string):Data de vinculação (ISO 8601).
  - `AccountProduct` (object):
  - `id` (string):ID do produto.
  - `name` (string):Nome do produto.
  - `price` (number):Preço unitário padrão do produto.
  - `description` (string | null):Descrição do produto.
  
  

---

## Exemplos

### Exemplo de requisição

```bash GET /api/v1/account-crm-pipeline-deal
curl --request GET \
  --url 'https://crm.wavups.com/api/v1/account-crm-pipeline-deal?stageId=cmkfy4kdk0009y0c1qx9fgumt' \
  --header 'Token: SEU_TOKEN_DE_API'
```

### Exemplo de resposta

```json 200
[
  {
  "id": "cmsnopzzl002l01ukfjsxp80a",
  "stageId": "cmkfy4kdk0009y0c1qx9fgumt",
  "leadId": "cmsncjkqw0bzx0hll2lv5i34a",
  "dealOwner": "cmuser0012345",
  "title": "Gabriel Cerrini (GC)",
  "description": "Proposta de consultoria e software",
  "value": 1350.0,
  "status": "open",
  "type": "Serviço",
  "nextAction": "Apresentar proposta comercial",
  "source": "whatsapp",
  "probability": 70,
  "order": 0,
  "expectedClose": "2026-09-15T00:00:00.000Z",
  "wonAt": null,
  "lostAt": null,
  "currency": "BRL",
  "lossReasonId": null,
  "lossNote": null,
  "createdAt": "2026-08-10T20:29:21.393Z",
  "AccountCRMLead": {
  "id": "cmsncjkqw0bzx0hll2lv5i34a",
  "name": "Gabriel Cerrini (GC)",
  "email": "gabriel@email.com",
  "phone": "+5511999998888"
  },
  "AccountUser": {
  "id": "cmuser0012345",
  "User": {
  "name": "Vendedor Proativia",
  "email": "vendedor@empresa.com"
  }
  },
  "AccountCRMPipelineStage": {
  "id": "cmkfy4kdk0009y0c1qx9fgumt",
  "name": "1ºContato",
  "pipelineId": "cmkfy4k700008y0c1phx38422"
  },
  "accountCRMPipelineDealProductAssignments": [
  {
  "id": "cpassign001",
  "accountProductId": "cmprod001",
  "quantity": 1,
  "discount": 10,
  "discountType": "PERCENTAGE",
  "totalPrice": 1350.0,
  "createdAt": "2026-08-10T20:29:21.400Z",
  "AccountProduct": {
  "id": "cmprod001",
  "name": "Plano Anual Consultoria",
  "price": 1500.0,
  "description": "Consultoria continuada para vendas"
  }
  }
  ]
  }
]
```

```json 500
{
  "error": "Error to get account CRM pipeline deals"
}
```