1. Email Account
Plusvibe.ai API Documentation
  • Getting Started
    • Getting Started
    • Webhooks - Overview
    • Webhooks - Payload - Email Replies
    • Webhooks - Payload - Lead Marked As Label
    • Webhooks - Payload - Campaign Emails Sent
    • Webhooks - Payload - Bounced Email
    • Webhooks - Payload - Unibox Email Sent
    • Webhooks - Payload - System Alert
    • Workspace Deep Link Parameter
  • User API Endpoints
    • Workspace
      • Get workspaces
      • Add a new workspace
      • Copy workspace settings
      • Invite a user to a workspace
    • Campaign
      • Create a new campaign
      • Create a new subsequence
      • List all campaigns
      • Get campaign name
      • Get campaign status
      • Get campaign email accounts
      • Get campaign emails
      • Get campaign variation stats
      • Set campaign name
      • Activate campaign
      • Pause campaign
      • Update Campaign
      • Delete or archive a campaign
      • Duplicate campaign
      • Bulk Assign/Remove Tags from Campaigns
    • Lead
      • Add leads to a campaign
      • Add leads to a subsequence campaign
      • Get or search for lead
      • Delete leads from a campaign
      • Lead Variable/Label Update or Add
      • Fetch workspace leads
      • Update the status of a lead
      • Get lead counts by status
    • Email Account
      • List all email accounts in the workspace
        GET
      • Get email account status
        GET
      • Check account vitals
        POST
      • Enable Email account warmup
        POST
      • Pause Email account warmup
        POST
      • Delete Email account
        POST
      • Get Warmup Stats (Workspace-Level)
        GET
      • Bulk Add SMTP Accounts
        POST
      • Bulk Update Email Accounts
        PUT
      • Bulk Update Email Account Warmup Status
        PATCH
      • Bulk Assign/Remove Tags from Email Accounts
        PUT
      • Bulk reconnect email accounts
        POST
      • Get workspace email stats for a date range
        GET
      • Move Email Accounts to Another Workspace
        POST
      • Get email account stats for a date range (per mailbox)
        GET
    • Analytics
      • Get campaign summary
      • Get campaign stats
      • Get workspaces summary
      • Get workspaces performance
      • Get all campaigns statistics
    • Unibox
      • Get email threads (conversations)
      • Get emails
      • Get emails in Others folder
      • Get count of unread emails
      • Reply to an email
      • Forward an existing email
      • Compose New Email
      • Mark Email Read
      • Send to any address
      • Save Email as Draft
      • Delete an Entire Email Thread
      • Delete a Single Email Message
    • Blocklist
      • Get entries in the blocklist
      • Adds entries to the blocklist
      • Delete entries in the blocklist
    • Webhook
      • Add a new webhook
      • List webhooks
      • Delete webhook(s)
    • Tags
      • List Tags
      • Create a New Tag
      • Update an Existing Tag
      • Delete Multiple Tags
    • Client Access
      • Create client
      • Edit client
      • Update client status
      • Delete client
      • List clients
    • Email Placement Test
      • Child (Test Run) Test
        • List child (Test Run) tests
        • Get child test details
      • Results & Analytics
        • Get test summary
        • Get detailed test statistics
        • Get test result for a sender account
      • Parent Test (Recurring & One-off)
        • Create a new parent test
        • Update a parent test
        • List all parent tests
        • Get parent test details
        • Delete parent test(s)
        • Duplicate a parent test
      • Get recipient providers
    • Workspace Additional Fields
      • List Additional Fields
      • Create Additional Field
      • Update Additional Field Default Value
      • Delete Additional Field
    • DFY
      • Search Domain Availability
      • List DFY Subscriptions
      • Generate Sender Identities (MS Enterprise)
      • Place a DFY Order
      • Cancel a DFY Subscription
    • Email Account Automation
      • List automation rules
      • Create automation rule
      • Update automation rule
      • Delete automation rule
      • Get automation rule
      • Enable / disable automation rule
      • Duplicate automation rule
    • Workspace Settings
      • Get Workspace Settings
      • Update Workspace Settings
      • List Lead Labels
      • Add Custom Lead Label
      • Delete Custom Lead Labels
    • Schemas
      • ScheduleV2
      • Campaign
      • EmailAccountId
      • WarmupStatus
      • BulkUpdateWarmupRequest
      • TagAction
      • BulkTagAssignmentRequest
      • ObjectId
      • HexColor
      • CreateTagRequest
      • UpdateTagRequest
      • DeleteTagsRequest
      • DeleteCampaignRequest
      • BulkReconnectRequest
      • SuccessResponse
      • ErrorResponse
      • ClientWorkspacePermission
      • CreateClientRequest
      • CreateClientResponse
      • UpdateClientRequest
      • ClientListItem
      • PatchClientStatusRequest
      • GenericSuccessResponse
      • ParentTest
      • ParentTestDetail
      • ChildTest
      • ChildTestDetail
      • VariationStepStats
      • VariationStats
      • CopyWorkspaceRequest
      • ResourceType
      • CopyWorkspaceResponse
      • EmailStatsResponse
      • EmailStatsHeader
      • EmailStatsChartPoint
      • ValidationErrorResponse
      • CheckSuccess
      • AuthFailure
  • For Email Infra Provider
    • Email Infra Provider Guide
    • List workspaces
    • List all email accounts in the workspace
    • Check if an email exists in another workspace
    • Initiate Google OAuth login flow
    • Initiate Microsoft OAuth login flow
    • Bulk Add SMTP Accounts (via Username and Password)
    • Schemas
      • AuthFailure
      • CheckSuccess
      • ErrorResponse
  1. Email Account

Get workspace email stats for a date range

GET
https://api.plusvibe.ai/api/v1/account/email-stats
Returns aggregated email statistics for the whole workspace over the given
date range, broken down per day in the chart array and summed up in the
header object.
Use this endpoint for workspace-level reporting: overall volume, reply and
bounce rates, and slices by sending provider, recipient provider, tags or
sending domain. For per-mailbox numbers use
Get email account stats for a date range (per mailbox).

Filters#

All filters are optional and combinable. A request with no filters
(only workspace_id + dates) returns stats for every sending
mailbox in the workspace.
provider — comma-separated list of sender provider types.
Allowed values: GOOGLE_WORKSPACE, MICROSOFT365,
REGULAR_ACCOUNT (i.e. SMTP/IMAP).
tags — comma-separated list of tag ObjectIds assigned to email accounts. Example: tags=66f0a1...,66f0a2....
recp_provider — comma-separated list of recipient provider types (the provider of the address being mailed to). Same allowed values as provider. Combine with provider to look at one sender-provider / recipient-provider pair, e.g. Microsoft 365 mailboxes sending into Google Workspace inboxes.
domain — comma-separated list of sending domains (e.g. domain=acme.com,acme.io). Restricts stats to mailboxes whose email address belongs to one of the listed domains. Cannot be combined with provider or tags (returns 400).

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Query Params

Responses

🟢200OK
application/json
Aggregated stats for the requested workspace and range.
Bodyapplication/json

🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.plusvibe.ai/api/v1/account/email-stats?workspace_id=6509f7691205283f2a79f98c&start_date=2026-03-01&end_date=2026-03-31&provider=&tags=&recp_provider=&domain=' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Whole workspace, March 2026
{
    "header": {
        "total_sent_count": 3936,
        "total_reply_count": 145,
        "total_ooo_reply_count": 3,
        "total_open_count": 0,
        "total_bounce_count": 31,
        "total_contacted_count": 1408,
        "total_completed_count": 1231,
        "total_pos_reply_count": 101,
        "bounce_rate": 0.8,
        "open_rate": 0,
        "reply_rate": 9.6,
        "reply_rate_with_ooo": 9.8,
        "pos_reply_rate": 69.7,
        "total_unique_contacted_count": 1503
    },
    "chart": [
        {
            "label": "1 Mar 26",
            "date": "2026-03-01",
            "total_sent_count": 49,
            "total_reply_count": 1,
            "total_ooo_reply_count": 0,
            "total_open_count": 0,
            "total_bounce_count": 0,
            "total_contacted_count": 8,
            "total_completed_count": 29,
            "total_pos_reply_count": 1
        },
        {
            "label": "2 Mar 26",
            "date": "2026-03-02",
            "total_sent_count": 45,
            "total_reply_count": 1,
            "total_ooo_reply_count": 0,
            "total_open_count": 0,
            "total_bounce_count": 0,
            "total_contacted_count": 24,
            "total_completed_count": 14,
            "total_pos_reply_count": 1
        },
        {
            "label": "3 Mar 26",
            "date": "2026-03-03",
            "total_sent_count": 132,
            "total_reply_count": 5,
            "total_ooo_reply_count": 0,
            "total_open_count": 0,
            "total_bounce_count": 1,
            "total_contacted_count": 51,
            "total_completed_count": 40,
            "total_pos_reply_count": 4
        }
    ]
}
Modified at 2026-09-12 08:42:30
Previous
Bulk reconnect email accounts
Next
Move Email Accounts to Another Workspace
Built with