Get ZapPulse Insights

GET

/zappulse/insights

Returns workspace-level analytics: every enrolled mailbox with its latest check results, status by provider, plan split, weekly results and placement, the hourly and daily test pulse, the latest placement per provider, how many mailboxes fail each sending practice and the raw sending figures of the mailboxes that were tested.

Request

Query Params

Header Params

Responses

🟢200

application/json

Insights fetched

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zapmail.ai/api/zappulse/insights?weeks=' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;'

Response Example

{
    "status": 200,
    "message": "Zappulse insights fetched successfully",
    "data": {
        "generatedAt": "2026-11-10T11:53:54.981Z",
        "weeks": 8,
        "truncated": false,
        "mailboxes": [
            {
                "id": "2c6f0a52-1f0e-4d7e-9d73-3f2b0d3f1a11",
                "email": "sam@example-sender.com",
                "firstName": "Sam",
                "lastName": "Carter",
                "profilePicture": "https://example.com/photos/sam.jpg",
                "domain": "example-sender.com",
                "provider": "GOOGLE",
                "status": "fix_sending",
                "lastTestedAt": "2026-11-07T04:10:01.267Z",
                "google": "inbox",
                "microsoft": "inbox",
                "checks": {
                    "volume": "met",
                    "spacing": "fail",
                    "warmupRunning": "met",
                    "replyRate": "met",
                    "plainText": "met",
                    "noLinks": "met",
                    "noSignature": "met",
                    "noTrackingPixel": "met",
                    "bounceRate": "met"
                },
                "allMet": false,
                "values": {
                    "coldPerDayMax": 15,
                    "medianGapMinutes": 10.8,
                    "replyRateWarmup": 99,
                    "bounceRate": 0,
                    "warmupEnabled": true,
                    "sampled": 20,
                    "html": 0,
                    "links": 0,
                    "signature": 0,
                    "pixel": 0
                }
            },
            {
                "id": "7b1d9e60-4a3c-4f55-b8a2-0a6c4c9e2d22",
                "email": "alex@example-sender.com",
                "firstName": "Alex",
                "lastName": "Rivera",
                "profilePicture": null,
                "domain": "example-sender.com",
                "provider": "MICROSOFT",
                "status": "not_tested",
                "lastTestedAt": null,
                "google": null,
                "microsoft": null,
                "checks": null,
                "allMet": null,
                "values": null
            }
        ],
        "providerStatus": [
            {
                "provider": "GOOGLE",
                "status": "fix_sending",
                "count": 21
            },
            {
                "provider": "GOOGLE",
                "status": "healthy",
                "count": 4
            },
            {
                "provider": "GOOGLE",
                "status": "not_tested",
                "count": 77
            },
            {
                "provider": "MICROSOFT",
                "status": "warming_up",
                "count": 17
            }
        ],
        "planSplit": [
            {
                "tier": "none",
                "count": 178
            }
        ],
        "awaitingFirstTest": 85,
        "testedToday": 0,
        "dispatchHourUtc": 0,
        "pulse": {
            "hourly": [],
            "daily": [
                {
                    "t": "2026-11-07T00:00:00Z",
                    "google": {
                        "total": 186,
                        "spam": 0
                    },
                    "microsoft": {
                        "total": 186,
                        "spam": 0
                    },
                    "finished": 93
                }
            ]
        },
        "weeklyResults": [
            {
                "week": "2026-11-02",
                "status": "fix_sending",
                "count": 22
            },
            {
                "week": "2026-11-02",
                "status": "healthy",
                "count": 4
            },
            {
                "week": "2026-11-02",
                "status": "warming_up",
                "count": 41
            },
            {
                "week": "2026-11-02",
                "status": "watching",
                "count": 26
            }
        ],
        "weeklyPlacement": [
            {
                "week": "2026-11-02",
                "provider": "google",
                "total": 186,
                "spam": 0
            },
            {
                "week": "2026-11-02",
                "provider": "microsoft",
                "total": 186,
                "spam": 0
            }
        ],
        "latestPlacement": {
            "google": {
                "inbox": 93,
                "spam": 0,
                "none": 0
            },
            "microsoft": {
                "inbox": 93,
                "spam": 0,
                "none": 0
            }
        },
        "prospectShare": {
            "google": 47.1,
            "microsoft": 40.5,
            "sampleSize": 93
        },
        "practices": {
            "tested": 93,
            "allMet": 1,
            "items": [
                {
                    "key": "volume",
                    "failing": 1,
                    "unverified": 0
                },
                {
                    "key": "spacing",
                    "failing": 0,
                    "unverified": 0
                },
                {
                    "key": "warmupRunning",
                    "failing": 0,
                    "unverified": 0
                },
                {
                    "key": "replyRate",
                    "failing": 0,
                    "unverified": 62
                },
                {
                    "key": "bounceRate",
                    "failing": 27,
                    "unverified": 40
                },
                {
                    "key": "plainText",
                    "failing": 22,
                    "unverified": 0
                },
                {
                    "key": "noLinks",
                    "failing": 18,
                    "unverified": 0
                },
                {
                    "key": "noSignature",
                    "failing": 0,
                    "unverified": 0
                },
                {
                    "key": "noTrackingPixel",
                    "failing": 0,
                    "unverified": 0
                }
            ]
        },
        "sending": [
            {
                "id": "2c6f0a52-1f0e-4d7e-9d73-3f2b0d3f1a11",
                "email": "sam@example-sender.com",
                "coldSent": 8,
                "coldPerDayMax": 4,
                "medianGapMinutes": 37.3,
                "replyRateWarmup": null,
                "bounceRate": 25
            }
        ]
    }
}

Modified at 2026-11-10 11:55:55

Get ZapPulse Overview

List ZapPulse Mailboxes