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
      • Get Warmup Stats (Per Mailbox)
        GET
      • 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 all campaigns statistics
      • Get workspaces performance
    • 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
      • EmailStatsHeader
      • EmailStatsResponse
      • 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 Warmup Stats (Per Mailbox)

GET
https://api.plusvibe.ai/api/v1/account/warmup-stats/bulk
Returns warmup results (inbox, spam, promotion) for the given date range for every mailbox individually, 100 mailboxes per page. Each item carries the mailbox's totals and inbox rates over the range and, optionally, a per-day chart_data array.
Use page to walk through all mailboxes in the workspace (ordered by mailbox ID). Mailboxes without warmup activity in the range are included with zero counts. The date range may span at most 14 days (warmup stats are kept for the last 14 days). Set include_chart=false when only the totals are needed.
For workspace totals use Get Warmup Stats (Workspace-Level).

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/warmup-stats/bulk?workspace_id=6509f7691205283f2a79f98c&start_date=2026-03-01&end_date=2026-03-14&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 warmup 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/warmup-stats/bulk?workspace_id=6509f7691205283f2a79f98c&start_date=2026-03-01&end_date=2026-03-14&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",
            "warmup_status": "ACTIVE",
            "google_percent": "98.7",
            "microsoft_percent": "100.0",
            "other_percent": "99.1",
            "total_inbox_sent": 561,
            "total_spam_sent": 2,
            "total_promotion_sent": 1,
            "total_warmup_sent": 564,
            "inbox_percent": "99.5",
            "spam_percent": "0.4",
            "promotion_percent": "0.2",
            "chart_data": [
                {
                    "date": "1 Mar 26",
                    "dt": "2026-03-01",
                    "sent": 43,
                    "inbox": 42,
                    "spam": 1,
                    "promotion": 0
                },
                {
                    "date": "2 Mar 26",
                    "dt": "2026-03-02",
                    "sent": 41,
                    "inbox": 41,
                    "spam": 0,
                    "promotion": 0
                }
            ]
        }
    ]
}
Modified at 2026-09-19 06:27:44
Previous
Bulk Add SMTP Accounts
Next
Bulk Update Email Accounts
Built with