# API URL

**URL:** <https://community.hubspot.com/t/api-url/30640>\
**Category:** Marketplace Apps\
**Created:** [January 22, 2021, 1:30pm UTC](https://community.hubspot.com/t/api-url/30640 "2021-01-22T13:30:45Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![MNogueira3](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mnogueira3/32/69256_2.png) [@MNogueira3](https://community.hubspot.com/u/MNogueira3)\
**Post date:** [January 22, 2021, 1:30pm UTC](https://community.hubspot.com/t/api-url/30640/1 "2021-01-22T13:30:45Z")

</div>

Quero dentro desta query: [https://api.hubapi.com/crm/v3/objects/deals?hapikey=\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*&associations=contacts&associations=tickets&associations=companies&associations=products&properties=amount&properties=createdate&properties=dealstage&properties=hs\_analytics\_source&properties=hs\_forecast\_probability&properties=dealname&properties=num\_notes&properties=hs\_mrr&properties=hs\_arr](https://api.hubapi.com/crm/v3/objects/deals?hapikey= ********************* &associations=contacts&associations=tickets&associations=companies&associations=products&properties=amount&properties=createdate&properties=dealstage&properties=hs_analytics_source&properties=hs_forecast_probability&properties=dealname&properties=num_notes&properties=hs_mrr&properties=hs_arr) filtrar apenas os negócios que foram vendidos (ganhos). Como faço isso? Outra coisa, como faço para trazer as propriedades que eu quero dentro das associações, como por exemplo: company\_name ou ticket\_name?

---

<div class="post-metadata">

**Author:** ![PamCotton](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/pamcotton/32/47916_2.png) [@PamCotton](https://community.hubspot.com/u/PamCotton)\
**Post date:** [January 26, 2021, 11:48pm UTC](https://community.hubspot.com/t/api-url/30640/2 "2021-01-26T23:48:49Z")

</div>

Olá @MNogueira3 tudo bem?

Gostaria de compartilhar esse post da [Comunidade aqui](https://community.hubspot.com/t5/CRM/Filtrar-neg%C3%B3cios-ganhos-via-API/m-p/403408#M314)onde compartilho um exemplo sobre, @DanielSanchez , @caiodonald , @angelopublio vocês saberiam mais informações para ajudar @MNogueira3 ?

Obrigada,

Pam

---

<div class="post-metadata">

**Author:** ![angelopublio](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/angelopublio/32/59874_2.png) [@angelopublio](https://community.hubspot.com/u/angelopublio)\
**Post date:** [January 27, 2021, 11:07am UTC](https://community.hubspot.com/t/api-url/30640/3 "2021-01-27T11:07:00Z")

</div>

Salve, @MNogueira3 !

Para filtrar por um estágio do pipeline, use como propriedade de filtro: “dealstage” e o valor referente ao estágio desejado.

Se estiver usando o padrão do pipeline de Vendidos Ganhos, use “closedwon”.

Para saber o valor, acesse Configurações \> Vendas \> Negócios \> Escolha o Pipeline e clique no icone \</\> ao lado do nome do estágio desejado.

 ![37046iF09643B2D8B5A63C.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/2/0/20bf2651063f72cf8db5d156ed78bae0ebb850a7.png)

Como você deseja filtrar negócios que são **iguais** ao valor informado, passe “EQ” como valor em “operador”.

Abaixo está o filtro final:

{  
“value”: “closedwon”,  
“propertyName”: “dealstage”,  
“operator”: “EQ”  
}

Sobre a segunda pergunta, em como obter informações das associações, é importante ressaltar que nem sempre uma chamada de API terá tudo que você precisa. Então, veja se combinando com outros endpoints vc consegue obter as informações que vc precisa. Você pode ver se a API de objetos associados de Deals te ajuda:

**GET** `/crm/v3/objects/deals/{dealId}/associations/{toObjectType}`

OU, então, com o ID do objeto associado, vc chama um endpoint que retorna as informações completas do objeto. Exemplo que recupera as propriedades/valores da empresa passando o ID da empresa: **GET** `/crm/v3/objects/companies/{companyId})`.

Bora codar!

Abraço!

---

<div class="post-metadata">

**Author:** ![GOliveira6](https://avatars.discourse-cdn.com/v4/letter/g/bc8723/32.png) [@GOliveira6](https://community.hubspot.com/u/GOliveira6)\
**Post date:** [June 28, 2022, 2:27pm UTC](https://community.hubspot.com/t/api-url/30640/4 "2022-06-28T14:27:42Z")

</div>

Bom dia Angelo! tudo na paz?

Eu estou enfrentando um problema parecido. Seguinte:

Tenho a URL para retornar as Deals:

[https://api.hubapi.com/crm/v3/objects/deals?limit=100&pipeline=default&archived=false&hapikey=\*\*\*\*](https://api.hubapi.com/crm/v3/objects/deals?limit=100&pipeline=default&archived=false&hapikey= **** )

Mas gostaria que retornasse somente as DEALS referente ao pipeline **default** , não importando em qual estágio esteja.

Quando executo a URL acima, retorna todos os pipelines.

Consegue me ajudar?

Muito obrigado

---

<div class="post-metadata">

**Author:** ![angelopublio](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/angelopublio/32/59874_2.png) [@angelopublio](https://community.hubspot.com/u/angelopublio)\
**Post date:** [June 28, 2022, 2:38pm UTC](https://community.hubspot.com/t/api-url/30640/5 "2022-06-28T14:38:50Z")

</div>

Salve, @GOliveira6!

Olhando a [documentação](https://developers.hubspot.com/docs/api/crm/deals), parece que esse Endpoint que você está usando não tem recurso de “filtro”.

Experimente usando o endpoint de “Search” (/crm/v3/objects/deals/ **search** ) passando o pipeline como “filtro” (filter) em “filterGroups”.

Boa sorte!

--Angelo