Aller au contenu
Lire les chiffres/Lire un deal

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èreValeur
AdresseGET /api/v1/pipeline/deals/:crmId
Par son nomPOST /api/v1/tools/get_pipeline_deal, la réponse sous data
Nom de l'outilget_pipeline_deal
Droit demandéLire le funnel (funnel.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, VP Sales, DAF, Lecteur / auditeur
Par MCPOui, en lecture.

Paramètres

crmId est dans l'adresse. Les autres suivent l'adresse, après ?.

ParamètreRequisType et limitesÀ quoi il sert
asOfouidate, AAAA-MM-JJLe jour de lecture. En général, aujourd'hui.
crmIdouitexte, 1 à 120 caractèresL'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.