Listar negócios

GET/api/v1/deals

Lista paginada de deals do workspace (soft-deletados ficam de fora). Filtros combináveis via query string; ordenação fixa por createdAt DESC.

Parâmetros de query

`limit` number	Itens por página, inteiro entre 1 e 100. default: `20`
`cursor` string	Cursor opaco de paginação · passe o `nextCursor` da resposta anterior. Omita na primeira página.
`status` enum	Filtra pelo status do deal. `OPENWONLOST`
`stageId` string	Só deals de um estágio específico.
`pipelineId` string	Só deals de um funil específico.
`ownerId` string	Só deals de um vendedor (dono) específico.
`q` string	Busca no título · case-insensitive, casa por trecho ("monte" acha "Construtora Montenegro").
`since` string (ISO 8601)	Só itens criados a partir desta data (`createdAt >=`, inclusive). Ex.: `2026-01-01T00:00:00Z`.
`until` string (ISO 8601)	Só itens criados antes desta data (`createdAt <`, exclusive).

Paginação cursor-based · quando hasMore: false, nextCursor: null e você para de paginar.

Autenticação: header Authorization: Bearer rmk_... · veja Introdução e autenticação.

curl "https://crmdojordao.com.br/api/v1/deals" \
  -H "Authorization: Bearer rmk_SUA_CHAVE"

Resposta · GET /api/v1/deals

{
  "data": [
    {
      "id": "deal_abc123",
      "title": "Lead João - Proposta Premium",
      "valueCents": 250000,
      "currency": "BRL",
      "status": "OPEN",
      "pipelineId": "pip_vendas",
      "stageId": "stg_novo_lead",
      "ownerId": "usr_maria",
      "accountId": "acc_empresa_exemplo",
      "contactIds": ["ct_joao"],
      "expectedCloseAt": "2026-08-15T00:00:00.000Z",
      "closedAt": null,
      "lostReasonId": null,
      "lostReason": null,
      "customFields": {
        "fonte_lead": "Site"
      },
      "createdAt": "2026-07-01T13:30:00.000Z",
      "updatedAt": "2026-07-01T13:30:00.000Z"
    }
  ],
  "nextCursor": "eyJpZCI6ImRlYWxfYWJjMTIzIiwiY3JlYXRlZEF0IjoiLi4uIn0",
  "hasMore": true
}