List the reports an account received
deliveries.received.list
For an account (child organization): the reports its workspace sent to it, newest first, paginated by cursor (limit 50 by default, up to 200; a cursor that is not this list's is invalid_cursor): each item is one send that went out (failed ones are left out) with its delivery_id and send_id, the workspace's name, sent_at, the report titles and their PDF download links (signed, valid 7 days after the send). Covers the last 20 sends of up to 100 deliveries to the account. Called on a workspace it returns an empty list (a workspace does not receive deliveries). Requires view access to Deliveries in the account. With Google Ads, Google Business Profile, LinkedIn, TikTok or YouTube, 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
deliveries:read- Permissão
- Ver o módulo
- Tool do MCP
deliveries_received_listNa superfície completa; na compacta,mb_execute_operationcomid: "deliveries.received.list".
Custo declarado: até 2102 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
limitintegerqueryopcionalHow many received reports per page (default 50, at most 200).
Padrão: 50
cursorstringqueryopcionalThe next_cursor of the previous page, to get the next one; omit it for the first page.
Resposta
dataarray<object>has_morebooleannext_cursorstringErros
Exemplo
curl "https://api.mb-suite.com/v1/deliveries/received" \
-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/deliveries/received" \
-H "Authorization: Bearer $MB_TEST_KEY"