List Warmup Subscriptions

POST

https://api.inboxkit.com/v1/api/warmup/list

Maintainer:Not configured

List the warmup subscriptions in your workspace. Warmup added when buying mailboxes appears here as pending_activation until each mailbox is ready.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Success Response

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/warmup/list' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "limit": 10,
    "status": "active",
    "include_cancelled": false
}'

Response Example

200 - Example 1

{
    "error": false,
    "message": "Warmup subscriptions retrieved successfully",
    "subscriptions": [
        {
            "uid": "ws-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "status": "active",
            "mailbox_email": "[email protected]",
            "price_per_month": 3,
            "health_status": "excellent",
            "started_at": "2025-01-15T10:30:00.000Z",
            "next_billing_date": "2025-02-15T10:30:00.000Z",
            "cached_stats": {
                "emails_sent": 150,
                "emails_received": 120,
                "health_score": 85.5,
                "inbox_rate": 92.3,
                "current_volume": 25,
                "target_volume": 50,
                "warmup_day": 14,
                "config": {
                    "starting_volume": 12,
                    "daily_increase": 3,
                    "target_volume": 45,
                    "reply_rates": {
                        "inbox": {
                            "min": 30,
                            "max": 45
                        },
                        "promotions": {
                            "min": 15,
                            "max": 25
                        },
                        "spam": 100
                    }
                }
            },
            "mailbox": {
                "uid": "mb-123e4567-e89b-12d3-a456-426614174000",
                "username": "john",
                "domain_name": "example.com",
                "first_name": "John",
                "last_name": "Doe",
                "platform": "GOOGLE",
                "status": "active"
            },
            "createdAt": "2025-01-15T10:30:00.000Z"
        }
    ],
    "total": 25,
    "pages": 3,
    "current_page": 1,
    "limit": 10
}

Modified at 2026-09-28 15:39:16

Get Wallet Logs

Get Warmup Subscription Details