Allo

Rechercher des deals

Cet endpoint est pagine. Utilisez page et size dans le corps de la requete pour controler les resultats. Voir Pagination.

POST/v2/api/crm/deals/search

Cet endpoint est pagine. Utilisez page et size dans le corps de la requete pour controler les resultats. Voir Pagination.

Corps de la requete

ChampTypeDescription
filtersobjectFiltres nommes (voir ci-dessous)
searchstringRecherche en texte integral sur le nom du deal et l'entreprise
sortstringOrdre de tri : DATE_DESC, DATE_ASC, NAME_ASC, NAME_DESC, CREATED_DESC, CREATED_ASC
pageintegerNumero de page (commence a 1)
sizeintegerResultats par page (max 100)

Filtres

ChampType de correspondanceDescription
stageexactEtape/statut du deal

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Corps

filtersobject | null

Named filters. Combined with AND.

1 champs
stagestring

Filter by deal stage/status (exact match)

searchstring | null

Free-text search across deal name and company

sortenum<string>

Sort order (default: DATE_DESC)

DATE_DESCDATE_ASCNAME_ASCNAME_DESCCREATED_DESCCREATED_ASC

pageinteger

Page number (1-indexed)

sizeinteger

Results per page

Réponses

200Search results
dataobject[]
9 champs
idstring

Unique deal identifier

namestring

Deal name

statusstring | null

Current deal status

amountnumber | null

Deal monetary value

currencystring | null

Three-letter ISO 4217 currency code

closed_atstring<date-time> | null

When the deal was closed (ISO 8601)

companyobject | null

Embedded company reference

2 champs
idstring

Company ID

namestring

Company name

created_atstring<date-time>

When the deal was created

updated_atstring<date-time>

When the deal was last updated

paginationobject
5 champs
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
401
422
429