---
title: "List Deals"
method: GET
path: "/v3/deals"
tags: ["Negócios"]
---

# List Deals

`GET /v3/deals`

Listar as oportunidades paginadas

## Response `200`

- object
  - `totalCount` number — Total de registros
  - `data` Deal[]
    - `id` string, required
    - `_id` string, required
    - `name` string, required — Nome do negócio
    - `value` number, required — Valor em dinheiro do negócio
    - `ticketId` string — ID sequencial do ticket
    - `description` string — Descrição do ticket
    - `slaDueAt` string, date-time — Prazo de SLA do ticket
    - `lostReason` string[] — Motivos de perda
    - `productsLostReason` object[] — Motivos de perda por produto
    - `products` DealProduct[]
      - `id` string, required
      - `name` string, required
      - `price` number, required
      - `quantity` number, required
      - `discount` number, required
      - `discountType` 'percentage' | 'value', required
      - `total` number, required
    - `lostReasonObs` string — Observação de perda
    - `wonLostDate` string, date-time — Data de perda ou ganho
    - `dueDate` string, date-time — Data de vencimento
    - `status` 'open' | 'won' | 'lost', required — Status do negócio
    - `contact` DealContact
      - `id` number, required
      - `name` string, required
      - `avatar` string, required
      - `phone` string, required
      - `email` string, required
      - `createdAt` string, date-time
      - `isPrivate` boolean
    - `conversation` DealConversation
      - `id` number, required
      - `platformId` number, required
      - `lastMessageAt` string, date-time
      - `showPending` boolean, required
      - `pendingAt` string, date-time
    - `operatorId` number — ID do usuário responsável pelo negócio
    - `groupId` number — ID do grupo associado ao negócio
    - `pipelineId` string, required — ID do pipeline associado ao negócio
    - `stageId` string, required
    - `origin` string
    - `campaign` string
    - `authorType` 'user' | 'bot' | 'automation' | 'workflow' | 'unknown' | 'cadence' | 'api'
    - `authorId` object
    - `tagIds` number[]
    - `position` number
    - `focusedCounts` number
    - `tasks` object
    - `timeInStage` object
    - `lastStageChanged` string, date-time
    - `comments` number
    - `context` DealContext
      - `automationId` string
      - `importId` string
    - `customFields` object, required

---

[API](https://skmtc.net/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.net/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kinbox/kinbox-api/versions/c8469f0ba490/schema)