Menú

Referencia de la API · Envíos

Historial de envíos

deliveries · sends · 2 operaciones

GET/v1/deliveries/{delivery_id}/sends

List a delivery's send history

deliveries.sends.list

LecturaIdempotenteDesde 2026-11-01

Lists the send history of a delivery, newest first, paginated by cursor (limit 50 by default, up to 200): when each send went out (sent_at) and who sent it (sent_by with sent_by_name; «MB Suite» for the scheduler), whether it was manual or scheduled (trigger), its outcome (sent, partial, failed) and errors, the recipients, the data period (date_range), the report PDFs (pdf_urls by template id, signed download links valid 7 days after the send; template_snapshots with each template's title and version) and the dashboard links. The stored copy of the email HTML is left out (deliveries.sends.get returns it). The status filter reads further until the page is full (up to 600 sends per call), so a page is short only when the outcome is rare: keep following next_cursor while has_more is true. Requires view access to Deliveries. 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 (the permissions guide lists what each platform allows).

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

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

Parámetros

delivery_idstringrutarequerido

The delivery id (deliveries.deliveries.list).

limitintegerqueryopcional

How many sends 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.

statusenumqueryopcional

Only sends with this outcome: sent, partial or failed.

Valores: sent, partial, failed

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/deliveries/{delivery_id}/sends" \
  -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/{delivery_id}/sends" \
  -H "Authorization: Bearer $MB_TEST_KEY"
GET/v1/deliveries/{delivery_id}/sends/{send_id}

Get one send of a delivery

deliveries.sends.get

LecturaIdempotenteDesde 2026-11-01

Returns one send of a delivery's history with everything deliveries.sends.list returns plus email_html, the HTML the recipients received (images as public signed links; sends made before 2026-10-15 stored it before signing, with the screen's image links). Not found: delivery_not_found (the delivery) or delivery_send_not_found (the send). Requires view access to Deliveries. 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 (the permissions guide lists what each platform allows).

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

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

Parámetros

delivery_idstringrutarequerido

The delivery id (deliveries.deliveries.list).

send_idstringrutarequerido

The send id (deliveries.sends.list).

Respuesta

idstring

Send id.

delivery_idstring

The delivery it belongs to.

sent_atnumber

When it went out (epoch ms).

triggerenum

manual (send now) or scheduled (the scheduler).

Valores: manual, scheduled

statusenum

sent, partial or failed.

Valores: sent, partial, failed

recipientsarray<string>

The To addresses it went to.

sent_bystring

Uid of who sent it (system-cron for the scheduler).

sent_by_namestring

Their name («MB Suite» for the scheduler).

date_rangeobject | null

The period it covered (YYYY-MM-DD).

template_snapshotsobject

Template id → title and version at the time of the send.

pdf_urlsobject

Template id → signed link to its PDF (expires 7 days after the send).

dashboard_linksobject

Dashboard id → title and link.

errorsarray<object>

Why it failed, when it did.

email_htmlstring

deliveries.sends.get only: the HTML the recipients received.

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/deliveries/{delivery_id}/sends/{send_id}" \
  -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/{delivery_id}/sends/{send_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"