Lire un deal
Donne un deal par son identifiant dans le CRM.
Sa société et son nom, son montant, son étape, son canal et ses sources, ses dates, son cycle face à la médiane de son canal, son motif de perte ou de gain, son poids dans la prévision tant qu'il est ouvert, son client et ses factures une fois gagné.
Le montant, le canal et le client d'un deal gagné demandent aussi le droit de lire le rendement par canal. Le propriétaire du deal n'est jamais donné.
Appel
| Repère | Valeur |
|---|---|
| Adresse | GET /api/v1/pipeline/deals/:crmId |
| Par son nom | POST /api/v1/tools/get_pipeline_deal, la réponse sous data |
| Nom de l'outil | get_pipeline_deal |
| Droit demandé | Lire le funnel (funnel.read) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, VP Sales, DAF, Lecteur / auditeur |
| Par MCP | Oui, en lecture. |
Paramètres
crmId est dans l'adresse. Les autres suivent l'adresse, après ?.
| Paramètre | Requis | Type et limites | À quoi il sert |
|---|---|---|---|
asOf | oui | date, AAAA-MM-JJ | Le jour de lecture. En général, aujourd'hui. |
crmId | oui | texte, 1 à 120 caractères | L'identifiant du deal dans le CRM. |
Exemple
curl "$MARVESTO_URL/api/v1/pipeline/deals/9001?asOf=2026-11-12" \
-H "x-api-key: $MARVESTO_API_KEY"Réponse
Le deal, comme sa fiche le montre sur l'écran Pipeline.
Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.