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
| Champ | Type | Description |
|---|
filters | object | Filtres nommes (voir ci-dessous) |
search | string | Recherche en texte integral sur le nom du deal et l'entreprise |
sort | string | Ordre de tri : DATE_DESC, DATE_ASC, NAME_ASC, NAME_DESC, CREATED_DESC, CREATED_ASC |
page | integer | Numero de page (commence a 1) |
size | integer | Resultats par page (max 100) |
Filtres
| Champ | Type de correspondance | Description |
|---|
stage | exact | Etape/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
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
created_atstring<date-time>
When the deal was created
updated_atstring<date-time>
When the deal was last updated
401
422
429