Reports · Email Marketing · API reference

GET/v1/email-marketing/reports

Get email marketing performance for a date range

email_marketing.reports.get

ReadIdempotentSince 2026-11-01

Returns the performance of the emails sent between start_date and end_date (epoch ms, up to 400 days): overview (sent, delivered, opened, clicked, bounced and open/click/bounce rates over delivered or sent), daily (one row per day, zero-filled), campaigns (sent or sending campaigns in the range with their stats and rates) and flows (every flow with what it sent in the range). types picks campaign and/or flow emails for overview and daily; sections picks what to return. With an API key or an app at most 20,000 sent emails are read per call, oldest first (truncated true means narrow the range) and at most 500 campaigns and flows. Requires view access to Email Marketing.

Scope: email_marketing:read
Permission: View the module
MCP tool: email_marketing_reports_getOn the full surface; on the compact one, mb_execute_operation with id: "email_marketing.reports.get".

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

Parameters

start_dateintegerqueryrequired

From (epoch ms).

end_dateintegerqueryrequired

To (epoch ms; up to 400 days after start_date).

typesarray<enum>queryoptional

Which sends the overview and the daily series count: campaign, flow or both (default).

Values: campaign, flow · Default: ["campaign","flow"]

sectionsarray<enum>queryoptional

Which parts to return: overview, daily, campaigns, flows (default all).

Values: overview, daily, campaigns, flows · Default: ["overview","daily","campaigns","flows"]

Response

truncatedboolean

logs_readnumber

overviewobject

dailyarray<object>

One row per day of the range (UTC days), zero-filled.

campaignsarray<object>

flowsarray<object>

Errors

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Example

curl "https://api.mb-suite.com/v1/email-marketing/reports?start_date=946684800000&end_date=946684800000" \
  -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/email-marketing/reports?start_date=946684800000&end_date=946684800000" \
  -H "Authorization: Bearer $MB_TEST_KEY"