Received reports

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).

Scope

deliveries:read

Permission

View the module

MCP tool

deliveries_received_listOn the full surface; on the compact one, mb_execute_operation with id: "deliveries.received.list".

Declared cost: up to 2102 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl "https://api.mb-suite.com/v1/deliveries/received" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/deliveries/received" \
  -H "Authorization: Bearer $MB_TEST_KEY"