# Get Warmup Stats (Individual Account) ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /account/warmup-stats: get: summary: Get Warmup Stats (Individual Account) deprecated: false description: >- Returns warmup metrics (inbox, spam, promotion) for a specified email account over a given date range. operationId: Email Account_email-account/get-warmup-stats-workspace-level tags: - Email Account - Email Account parameters: - name: workspace_id in: query description: The ID of the workspace. required: true schema: type: string description: The ID of the workspace. default: '' examples: - 6509f7691205283f2a78f98c - name: start_date in: query description: >- The start date for the warmup stats (inclusive). Must be in YYYY-MM-DD format. required: true schema: type: string description: >- The start date for the warmup stats (inclusive). Must be in YYYY-MM-DD format. default: '' format: date examples: - '2025-02-01' - name: end_date in: query description: >- The end date for the warmup stats (inclusive). Must be in YYYY-MM-DD format. required: true schema: type: string description: >- The end date for the warmup stats (inclusive). Must be in YYYY-MM-DD format. default: '' format: date examples: - '2025-02-28' - name: email_acc_id in: query description: The unique ID for the email account being queried. required: true schema: type: string examples: - 66fe7917d4198b6a2e46e508 - name: x-api-key in: header description: Your PlusVibe.ai account's API Key required: false example: '' schema: type: string description: Your PlusVibe.ai account's API Key default: '' examples: - your-api-key responses: '200': description: Successfully retrieved workspace-level warmup stats content: application/json: schema: type: object properties: status: type: string emailAcc: type: object properties: google_percent: type: string description: >- Percentage of emails to Google inboxes that landed in the inbox. other_percent: type: string description: >- Percentage of emails to non-Google/Microsoft inboxes that landed in the inbox. microsoft_percent: type: string description: >- Percentage of emails to Microsoft inboxes that landed in the inbox. total_inbox_sent: type: integer description: >- Total number of emails that landed in the inbox during the warmup period. total_spam_sent: type: integer description: >- Total number of emails that landed in spam during the warmup period. total_promotion_sent: type: integer description: >- Total number of emails that landed in promotions during the warmup period. total_warmup_sent: type: integer description: >- Total number of warmup emails sent across the workspace. inbox_percent: type: string description: Percentage of total emails that landed in the inbox. spam_percent: type: string description: Percentage of total emails that landed in spam. promotion_percent: type: string description: >- Percentage of total emails that landed in the promotions folder. chart_data: type: array items: type: object properties: date: type: string description: Readable date format (e.g., "1 Feb 25"). dt: type: string description: Standard date format (YYYY-MM-DD). inbox: type: integer description: >- Number of emails that landed in the inbox on this date (for all accounts). spam: type: integer description: >- Number of emails that landed in spam on this date (for all accounts). promotion: type: integer description: >- Number of emails that landed in promotions on this date (for all accounts). sent: type: integer description: >- Number of emails that sent on this date (for all accounts). x-apidog-orders: - date - dt - inbox - sent - spam - promotion description: >- Daily breakdown of inbox/spam/promotion counts across all email accounts in the workspace. total_inboxes: type: 'null' description: >- Total number of recipient inboxes used across all email accounts. total_domains: type: 'null' description: >- Total number of recipient domains used across all email accounts. email_domain_detail: type: object properties: plusvibeainow.com: type: number description: '' examples: - 2 tryplusvibeai.com: type: number description: '' examples: - 3 findplusvibeai.com: type: number description: '' examples: - 3 x-apidog-orders: - plusvibeainow.com - tryplusvibeai.com - findplusvibeai.com description: Breakdown of email volumes by domain. required: - google_percent - other_percent - microsoft_percent - total_inbox_sent - total_spam_sent - total_promotion_sent - total_warmup_sent - inbox_percent - spam_percent - promotion_percent - chart_data - total_inboxes - total_domains - email_domain_detail x-apidog-orders: - google_percent - other_percent - microsoft_percent - total_inbox_sent - total_spam_sent - total_promotion_sent - total_warmup_sent - inbox_percent - spam_percent - promotion_percent - chart_data - total_inboxes - total_domains - email_domain_detail required: - status - emailAcc x-apidog-orders: - status - emailAcc example: status: success emailAcc: google_percent: '92.1' other_percent: '100.0' microsoft_percent: '97.4' total_inbox_sent: 259 total_spam_sent: 11 total_promotion_sent: 0 total_warmup_sent: 270 inbox_percent: '95.9' spam_percent: '4.1' promotion_percent: '0.0' chart_data: - date: 7 Feb 25 dt: '2025-02-07' inbox: 9 spam: 1 sent: 10 promotion: 0 total_inboxes: null total_domains: null email_domain_detail: {} headers: {} x-apidog-name: OK '400': description: Bad request (missing parameters or invalid values). content: application/json: schema: type: object properties: {} x-apidog-orders: [] headers: {} x-apidog-name: Bad Request '401': description: Unauthorized (invalid or missing API key). content: application/json: schema: type: object properties: {} x-apidog-orders: [] headers: {} x-apidog-name: Unauthorized '500': description: Internal Server Error content: application/json: schema: type: object properties: {} x-apidog-orders: [] headers: {} x-apidog-name: Server Error security: - ApiKeyAuth: [] x-apidog: schemeGroups: - id: uS5KiuC4wfZHK42AzOfA_ schemeIds: - ApiKeyAuth required: true use: id: uS5KiuC4wfZHK42AzOfA_ scopes: uS5KiuC4wfZHK42AzOfA_: ApiKeyAuth: [] x-apidog-folder: Email Account x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/929054/apis/api-17238492-run components: schemas: {} securitySchemes: ApiKeyAuth: type: apikey in: header name: x-api-key description: | API key issued in the PlusVibe dashboard. The server reads it from the `x-api-key` header and injects it into the request as the `api_key` query parameter, which is why you will see `api_key` referenced in validation errors. apiKey: type: apikey in: body name: api_key description: API key passed in request body servers: - url: https://api.plusvibe.ai/api/v1 description: Prod Env security: - ApiKeyAuth: [] x-apidog: schemeGroups: - id: uS5KiuC4wfZHK42AzOfA_ schemeIds: - ApiKeyAuth required: true use: id: uS5KiuC4wfZHK42AzOfA_ scopes: uS5KiuC4wfZHK42AzOfA_: ApiKeyAuth: [] ```