Get the Zapwarm quote for selected mailboxes

POST

/zap-warm/quote

Quote for the eligible mailboxes among mailboxIds, with the wallet balance and whether the wallet covers the purchase.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zapmail.ai/api/zap-warm/quote' \
--header 'x-auth-zapmail: b3a1f6c2-5d4e-4f7a-9b8c-2e1d0c9b8a76' \
--header 'x-workspace-key: 0e9d8c7b-6a5f-4e3d-8c2b-1a0f9e8d7c6b' \
--header 'Content-Type: application/json' \
--data '{
    "mailboxIds": [
        "3f1c2a4e-8b7d-4e21-9a6c-1d2e3f405a61",
        "7a9b0c1d-2e3f-4a5b-8c6d-7e8f9a0b1c2d",
        "c4d5e6f7-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
    ]
}'

Response Example

{
    "status": 200,
    "message": "Zapwarm quote fetched successfully",
    "data": {
        "freeTrial": null,
        "count": 3,
        "freeSlots": 1,
        "slotsToBuy": 2,
        "unitPriceCents": 500,
        "proratedUnitPriceCents": 320,
        "prorated": true,
        "subtotalCents": 640,
        "discount": null,
        "totalCents": 640,
        "periodEnd": "2026-11-14T10:00:00.000Z",
        "eligibleMailboxIds": [
            "3f1c2a4e-8b7d-4e21-9a6c-1d2e3f405a61",
            "7a9b0c1d-2e3f-4a5b-8c6d-7e8f9a0b1c2d",
            "c4d5e6f7-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
        ],
        "ineligibleMailboxIds": [],
        "wallet": {
            "walletBalance": 2500
        },
        "walletCoversPurchase": true
    }
}

Modified at 2026-10-22 13:25:20

List mailboxes eligible for warmup

Start Zapwarm on selected mailboxes