Aller au contenu
Lire les chiffres/Lire un canal d'un budget

Lire un canal d'un budget

Donne un canal d'un budget, comme l'écran de pilotage le lit à un jour donné.

Son budget, son dépensé jusqu'au dernier mois arrêté, ce que ses contrats engagent encore, son reste et sa fin d'année prévue, chacun avec son statut.

Appel

RepèreValeur
AdresseGET /api/v1/budgets/:budgetId/channels/:channelKey
Par son nomPOST /api/v1/tools/get_channel, la réponse sous data
Nom de l'outilget_channel
Droit demandéLire le détail par canal, fournisseur et contrat (spendDetail.read)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, DAF, Lecteur / auditeur
Par MCPOui, en lecture.

Paramètres

budgetId et channelKey sont dans l'adresse. Les autres suivent l'adresse, après ?.

ParamètreRequisType et limitesÀ quoi il sert
budgetIdouitexte, non videLe budget. list_budgets donne les identifiants.
channelKeyouitexte, non videLe canal : une clé du catalogue (paid_media, events, content…).
asOfouidate, AAAA-MM-JJLe jour de lecture. En général, aujourd'hui.

Exemple

curl "$MARVESTO_URL/api/v1/budgets/BUDGET_ID/channels/paid_media?asOf=2026-11-12" \
  -H "x-api-key: $MARVESTO_API_KEY"

Réponse

channelKey, throughPeriod (le dernier mois arrêté lu), puis budget, actual (dépensé), committed (engagé), available (reste) et landing (fin d'année prévue).

Refus

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