---
title: "Buscar negócios"
method: GET
path: "/api/v1/businesses"
tags: ["Negócios"]
---

# Buscar negócios

`GET /api/v1/businesses`

## Query parameters

- `skip` number
- `take` number
- `search` string
- `filter` BusinessesFiltersDto
  - `lossReason` string — ID de motivo de perda. Este campo aceita um ID de motivo de perda do negócio.
  - `tags` string — ID ou lista de IDs de tags. Este campo aceita um ID ou uma lista de IDs de tags separados por vírgula, com uma operação opcional definida no início da string. Formato: `<operação> <id1>,<operação> <id2>,<operação> <id3>` Operação (opcional): define como os IDs serão interpretados, caso seja omitido a operação padrão é some. Pode ser: - `some` – pelo menos uma das tags - `every` – todas as tags - `none` – nenhuma das tags
  - `products` string — ID ou lista de IDs de produtos. Este campo aceita um ID ou lista de IDs separados por vírgula, com uma operação opcional definida no início da string. Formato: `<operação> <id1>,<operação> <id2>,<operação> <id3>` Operação (opcional): define como os IDs serão interpretados, caso seja omitido a operação padrão é some. Pode ser: - `some` – pelo menos um dos produtos - `every` – todos os produtos - `none` – nenhum dos produtos
  - `attendants` string[] — ID ou lista de IDs de atendentes. Formato: `<ID>,<ID1>,<ID2>` Detalhes: - Este campo aceita um ID ou uma lista de IDs separados por vírgula.
  - `fields` string — Expressões de filtro em campos adicionais do lead. Formato: `<idDoCampo> <operação> <valorDoCampo>` Parâmetros: - `idDoCampo`: ID do campo adicional do lead. - `operação`: opção do filtro. - `contains`: campo **contém** o valor. - `eq`: campo **igual** ao valor. - `not`: campo **não contém** o valor. - `valorDoCampo`: conteúdo do campo adicional do lead.
  - `status` string — Este campo aceita uma string contendo algum dos status de negócio. Campos de status disponíveis: - `won` - negócios ganhos - `in_process` - negócios em aberto - `lost` - negócios perdidos
  - `businessFields` string — Expressões de filtro em campos adicionais do negócio. Formato: `<idDoCampo> <operação> <valorDoCampo>` - `idDoCampo`: ID do campo adicional do negócio. - `operação`: opção do filtro. Operações disponíveis: - `contains`: campo contém o valor. - `eq`: campo igual ao valor. - `not`: campo não contém o valor. - `valorDoCampo`: conteúdo do campo adicional.
  - `source` string — Este campo aceita uma string contendo a origem do lead, todos os negócios do lead com a origem filtrada serão retornados
  - `minValue` number — Valor mínimo dos negócios a serem filtrado
  - `maxValue` number — Valor máximo dos negócios a serem filtrado
  - `startDate` string, date-time — Filtro de intervalo, negócios que estão em negociação ou estavam em negociação em determinado intervalo. Formato (ISO 8601): `YYYY-MM-DDTHH:mm:ss.sssZ`
  - `endDate` string, date-time — Filtro de intervalo, negócios que estão em negociação ou estavam em negociação em determinado intervalo Formato (ISO 8601): `YYYY-MM-DDTHH:mm:ss.sssZ`
  - `createdAtGreaterOrEqual` string, date-time — Negócios criados na data posterior (mais recentes) a informada ou na mesma data. Formato (ISO 8601): `YYYY-MM-DDTHH:mm:ss.sssZ`
  - `createdAtLessOrEqual` string, date-time — Negócios criados na data anterior (mais antigos) a informada ou na mesma data. Formato (ISO 8601): `YYYY-MM-DDTHH:mm:ss.sssZ`
  - `lastMovedAfter` string, date-time — Negócios movidos na data posterior (mais recentes) a informada ou na mesma data. Formato (ISO 8601): `YYYY-MM-DDTHH:mm:ss.sssZ`
  - `lastMovedBefore` string, date-time — Negócios movidos na data anterior (mais antigos) a informada ou na mesma data. Formato (ISO 8601): `YYYY-MM-DDTHH:mm:ss.sssZ`

## Response `200`

- object
  - `count` number, required
  - `data` BusinessDto[]
    - `id` string — ID do negócio.
    - `createdAt` string, date-time — Data de criação do negócio.
    - `stageId` string — ID do estágio atual do negócio.
    - `leadId` string — ID do lead associado ao negócio.
    - `attendantId` string — ID do atendente responsável pelo negócio.
    - `nextActivityId` string — ID da próxima atividade relacionada ao negócio.
    - `total` number — Valor total do negócio.
    - `discount` number — Valor de desconto aplicado ao negócio.
    - `addition` number — Valor de acréscimos aplicados ao negócio.
    - `shipping` number — Valor do frete relacionado ao negócio.
    - `coupon` string — Cupom de desconto utilizado no negócio.
    - `shippingType` string — Tipo de frete selecionado para o negócio.
    - `status` string — Status atual do negócio.
    - `code` number — Código interno do negócio.
    - `externalId` string — ID externo vinculado ao negócio.
    - `lastMovedAt` string, date-time — Data da última movimentação do negócio.
    - `statusChangedAt` string, date-time — Data da última alteração do status do negócio.
    - `products` BusinessProductDto[] — Lista de produtos associados ao negócio.
      - `id` string — Identificador único do produto no negócio.
      - `product` ProductDto
        - `id` string — Id do produto
        - `id_sku` string — Id SKU do produto
        - `name` string — Nome do produto
        - `price` number — Preço do produto
        - `createdAt` string, date-time — Data de criação do produto
      - `quantity` number — Quantidade do produto no negócio.
      - `price` number — Preço unitário do produto no negócio.
      - `total` number — Valor total do produto no negócio (preço x quantidade).
    - `lossReasonId` string — ID do motivo de perda do negócio.
    - `justification` string — Justificativa associada ao negócio.
    - `productsCount` number — Quantidade total de produtos no negócio.

---

[API](https://skmtc.dev/datacrazy/apis/api-crm-datacrazy.md) · [All operations](https://skmtc.dev/datacrazy/apis/api-crm-datacrazy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datacrazy/api-crm-datacrazy/revisions/681f3b1fe7c8/schema)