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 campaigns (deprecated)
      • List all campaigns
      • Get campaign name
      • Get campaign status
      • Get campaign email accounts
      • Get campaign emails
      • Get campaign variation stats
      • Set campaign name
      • Set campaign Schedules (deprecated)
      • Activate campaign
      • Pause campaign
      • Update Campaign
      • Delete or archive a campaign
      • Duplicate campaign
    • 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 email account stats for a date range (deprecated)
        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 count (deprecated)
      • 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 email account stats for a date range (per mailbox)

GET
https://api.plusvibe.ai/api/v1/account/email-stats/bulk
Returns statistics for the given date range for every sending mailbox individually, 100 mailboxes per page. Each item carries a header object with the mailbox's totals over the range and, optionally, a per-day chart array.
Use page to walk through all mailboxes in the workspace (ordered by mailbox ID). The date range may span at most 90 days. Set include_chart=false when only the totals are needed; the response is then a fraction of the size.

Fetching specific mailboxes#

Instead of paging, pass email_acc_ids with a comma-separated list of up to 100 email account IDs to return only those mailboxes in one call. page is ignored in that case, and has_more is always false.
GET /account/email-stats/bulk?workspace_id=6509f7691205283f2a79f98c&start_date=2026-03-01&end_date=2026-03-31&email_acc_ids=65a1b2c3d4e5f60718293a4b,65a1b2c3d4e5f60718293a4c
An ID that does not belong to the workspace is rejected with a 400 listing the unknown IDs in missing_ids.

Request

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

Responses

🟢200OK
application/json
Per-mailbox stats for the requested page.
Bodyapplication/json

🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.plusvibe.ai/api/v1/account/email-stats/bulk?workspace_id=6509f7691205283f2a79f98c&start_date=2026-03-01&end_date=2026-03-31&page=1&limit=100&include_chart=true' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - First page with per-day chart
{
    "page": 1,
    "limit": 100,
    "total_accounts": 248,
    "has_more": true,
    "accounts": [
        {
            "email_acc_id": "65a1b2c3d4e5f60718293a4b",
            "email": "sales@example.com",
            "header": {
                "total_sent_count": 94,
                "total_reply_count": 6,
                "total_ooo_reply_count": 1,
                "total_open_count": 0,
                "total_bounce_count": 1,
                "total_completed_count": 23,
                "total_pos_reply_count": 4,
                "bounce_rate": 1.1,
                "open_rate": 0,
                "reply_rate": 7.5,
                "reply_rate_with_ooo": 8.8,
                "pos_reply_rate": 66.7,
                "total_new_lead_contacted_count": 80,
                "total_contacted_count": 80
            },
            "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_completed_count": 11,
                    "total_pos_reply_count": 1,
                    "total_new_lead_contacted_count": 42
                },
                {
                    "label": "2 Mar 26",
                    "date": "2026-03-02",
                    "total_sent_count": 45,
                    "total_reply_count": 5,
                    "total_ooo_reply_count": 1,
                    "total_open_count": 0,
                    "total_bounce_count": 1,
                    "total_completed_count": 12,
                    "total_pos_reply_count": 3,
                    "total_new_lead_contacted_count": 38
                }
            ]
        },
        {
            "email_acc_id": "65a1b2c3d4e5f60718293a4c",
            "email": "outreach@example.com",
            "header": {
                "total_sent_count": 0,
                "total_reply_count": 0,
                "total_ooo_reply_count": 0,
                "total_open_count": 0,
                "total_bounce_count": 0,
                "total_completed_count": 0,
                "total_pos_reply_count": 0,
                "bounce_rate": 0,
                "open_rate": 0,
                "reply_rate": 0,
                "reply_rate_with_ooo": 0,
                "pos_reply_rate": 0,
                "total_new_lead_contacted_count": 0,
                "total_contacted_count": 0
            },
            "chart": [
                {
                    "label": "1 Mar 26",
                    "date": "2026-03-01",
                    "total_sent_count": 0,
                    "total_reply_count": 0,
                    "total_ooo_reply_count": 0,
                    "total_open_count": 0,
                    "total_bounce_count": 0,
                    "total_completed_count": 0,
                    "total_pos_reply_count": 0,
                    "total_new_lead_contacted_count": 0
                },
                {
                    "label": "2 Mar 26",
                    "date": "2026-03-02",
                    "total_sent_count": 0,
                    "total_reply_count": 0,
                    "total_ooo_reply_count": 0,
                    "total_open_count": 0,
                    "total_bounce_count": 0,
                    "total_completed_count": 0,
                    "total_pos_reply_count": 0,
                    "total_new_lead_contacted_count": 0
                }
            ]
        }
    ]
}
Modified at 2026-09-04 08:43:54
Previous
Move Email Accounts to Another Workspace
Next
Get campaign summary
Built with