Aller au contenu
Lire les chiffres/Lire l'objectif à date

Lire l'objectif à date

Donne l'objectif de l'exercice à un jour donné : ce qui était demandé, et ce qui est signé.

L'objectif du marketing et celui de l'entreprise, ce que demandaient les mois écoulés, et les montants signés des deals gagnés depuis le début de l'exercice.

Appel

RepèreValeur
AdressePOST /api/v1/tools/get_objective_progress
RéponseSous data.
Nom de l'outilget_objective_progress
Droit demandéLire les objectifs : objectif de l'entreprise, part du marketing (objectives.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, VP Sales, Responsable de programme, DAF, CEO, Lecteur / auditeur
Par MCPOui, en lecture.

Paramètres

Les paramètres sont dans le corps de la requête, en JSON.

ParamètreRequisType et limitesÀ quoi il sert
asOfouidate, AAAA-MM-JJLe jour de lecture. En général, aujourd'hui.

Exemple

curl -X POST "$MARVESTO_URL/api/v1/tools/get_objective_progress" \
  -H "x-api-key: $MARVESTO_API_KEY" \
  -H "content-type: application/json" \
  -d @corps.json

Le fichier corps.json :

{
  "asOf": "2026-11-12"
}

Réponse

Ce que l'écran affiche au membre de la clé : chaque valeur avec son statut, une valeur indisponible à null, et ce qui lui est masqué dit avec sa raison.

Refus

Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.