Menu

Referência da API · Monitors

Pacing

monitors · pacing · 1 operação

GET/v1/monitors/cross-account/{account_id}/pacing

Get the budget pacing of an account

monitors.pacing.get

LeituraIdempotenteDesde 2026-11-01

Returns the pacing of an account's active media plans, by platform: planned budget, spend synced from the platforms, spend as a percentage of the budget and a status (on_track, under_pacing when spend runs below 85% of the elapsed time, over_pacing above 105%). Reads only MB Suite data (no platform is called). Call it on the workspace with the account id (one it reaches: platform.orgs.list; any other is 404 account_not_found). An account without active media plans returns an empty list. Requires view access to Monitors. With Google Ads, LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Escopo
monitors:read
Permissão
Ver o módulo
Tool do MCP
monitors_pacing_getNa superfície completa; na compacta, mb_execute_operation com id: "monitors.pacing.get".

Custo declarado: até 101 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

account_idstringrotaobrigatório

The account (a child organization of the workspace) to check: an id from platform.orgs.list.

Resposta

account_idstring

The account.

dataarray<object>

The pacing by platform (empty without active media plans).

Erros

Exemplo

curl "https://api.mb-suite.com/v1/monitors/cross-account/{account_id}/pacing" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/monitors/cross-account/{account_id}/pacing" \
  -H "Authorization: Bearer $MB_TEST_KEY"