Listar negociações

Este end-point recupera uma lista paginada de todas as negociações na conta, permitindo a filtragem por diversos critérios, como funil, etapa ou proprietário. É útil para sincronizar dados de negociações com sistemas externos ou para construir painéis de visualização personalizados.

Filtro

Propriedades disponíveis para filtro usando RDQL.

PropriedadeTipoDescrição
idStringFiltra por um ou mais IDs de negociação.
nameStringFiltra por nome da negociação, suportando busca exata ou por correspondência (usando operador match ~).
ratingIntegerFiltra por um valor de classificação numérica da negociação.
statusStringFiltra por status da negociação.
closed_atDateTimeFiltra por data e hora de fechamento da negociação.
created_atDateTimeFiltra por data e hora de criação da negociação.
updated_atDateTimeFiltra por data e hora da última atualização da negociação.
expected_close_dateDateFiltra pela data de fechamento prevista da negociação.
organization_idStringFiltra por um ID de empresa.
contact_idStringFiltra por um ou mais IDs de contato.
stage_idStringFiltra por um ID de etapa do funil de vendas.
lost_reason_idStringFiltra por um ID de motivo de perda da negociação.
campaign_idStringFiltra por um ID de campanha.
owner_idStringFiltra por um ID de proprietário (usuário) da negociação.
pipeline_idStringFiltra negociações por um ID de funil de vendas.
product_idsStringFiltra negociações que contêm um ou mais IDs de produtos.
has:productBooleanFiltra negociações que têm produtos associados.
@<custom_field_slug>StringFiltra por um campo personalizado. Exemplo: filial:norte, erp_id:123.

Ordenação

Propriedades disponíveis para ordenação.

  • name
  • rating
  • created_at
  • updated_at
  • closed_at
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Filtro no formato RDQL. (Saiba mais)

sort
object

Ordenação. (Saiba mais)

page
object

Paginação. (Saiba mais)

Responses

429

O limite de requisições foi excedido.

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json