Menu

Referência da API · Envios

Histórico de envios

deliveries · sends · 2 operações

GET/v1/deliveries/{delivery_id}/sends

List a delivery's send history

deliveries.sends.list

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

Escopo
deliveries:read
Permissão
Ver o módulo
Tool do MCP
deliveries_sends_listNa superfície completa; na compacta, mb_execute_operation com id: "deliveries.sends.list".

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

Parâmetros

delivery_idstringrotaobrigatório

The delivery id (deliveries.deliveries.list).

limitintegerqueryopcional

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

Padrão: 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

Resposta

dataarray<object>
has_moreboolean
next_cursorstring

Erros

Exemplo

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

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

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

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

Parâmetros

delivery_idstringrotaobrigatório

The delivery id (deliveries.deliveries.list).

send_idstringrotaobrigatório

The send id (deliveries.sends.list).

Resposta

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.

Erros

Exemplo

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