Menú

Referencia de la API · Envíos

Reportes recibidos

deliveries · received · 1 operación

GET/v1/deliveries/received

List the reports an account received

deliveries.received.list

LecturaIdempotenteDesde 2026-11-01

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

Alcance
deliveries:read
Permiso
Ver el módulo
Tool del MCP
deliveries_received_listEn la superficie completa; en la compacta, mb_execute_operation con id: "deliveries.received.list".

Costo declarado: hasta 2102 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

limitintegerqueryopcional

How many received reports per page (default 50, at most 200).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, to get the next one; omit it for the first page.

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

Ejemplo

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

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

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