Analytics

Workspace analytics roll-up

Engagement rolled up across every campaign in the workspace, plus the highest-volume campaigns. Use it for a top-level dashboard; drill into a campaign for detail.

Requires one of the following scopes: metrics:read, all:read, all:all.

get/v1/campaigns/analytics/overview

Request

  • Base URL: https://api.mailbeast.ai
  • URL: https://api.mailbeast.ai/v1/campaigns/analytics/overview
  • Auth: HTTP bearer

Query parameters

startDatestring
Example:2026-06-01T00:00:00Z

Start of the reporting window (ISO-8601). ⚠️ Reporting is by whole calendar day in your workspace timezone – the time component is ignored, so this date counts from the START of that day.

endDatestring
Example:2026-06-30T23:59:59Z

End of the reporting window (ISO-8601). Defaults to now. ⚠️ Inclusive and by whole calendar day (time component ignored) – this counts through the END of that day in your workspace timezone.

excludeOOOboolean
Example:true

Exclude out-of-office auto-replies from reply counts and reply rate. Mirrors the dashboard toggle.

Response

activeCampaignsnumber required

Campaigns currently sending.

sendingAccountsnumber required

Connected sending accounts.

Example response

{
  "period": {
    "start": "2026-06-01T00:00:00.000Z",
    "end": "2026-06-30T23:59:59.000Z",
    "retentionDays": 90
  },
  "totals": {
    "sent": 1200,
    "failed": 8,
    "delivered": 1186,
    "leadsContacted": 640,
    "opens": {
      "total": 240,
      "uniqueLeads": 180
    },
    "clicks": {
      "total": 240,
      "uniqueLeads": 180
    },
    "replies": 26,
    "bounces": 14,
    "unsubscribed": 5,
    "positiveLeads": 21,
    "conversions": 6,
    "conversionValue": 18000,
    "rates": {
      "open": 42.5,
      "click": 8.1,
      "reply": 4.2,
      "bounce": 1.9,
      "delivery": 98.1,
      "unsubscribe": 0.4,
      "conversion": 2
    }
  },
  "activeCampaigns": 7,
  "sendingAccounts": 12,
  "topCampaigns": [
    {
      "campaignId": "c1a2b3d4-...",
      "name": "Q3 outbound – DACH",
      "sent": 1200,
      "openRate": 42.5
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.