InboxKit
  1. Warmup
InboxKit
  • Introduction
  • Order
    • Place Order
      POST
  • Webhook
    • Status Change Webhook
      POST
  • Account
    • Get account details
      GET
  • Workspaces
    • List workspaces
      GET
    • Get workspace details
      GET
    • Create workspace
      POST
    • Update workspace
      PUT
    • Delete workspace
      DELETE
    • Update workspace webhook
      POST
  • Domains
    • Search available domains
      POST
    • Check if domain is banned from registration
      GET
    • Check domain availability
      GET
    • Register domains
      POST
    • List domains
      POST
    • List assignable domains
      GET
    • Remove domains
      POST
    • Set domain forwarding
      POST
    • Set catch-all email
      POST
    • Remove catch-all email
      DELETE
    • Get nameservers for domain connection
      POST
    • Check nameservers propagation
      POST
    • Check Workspace Availability
      POST
    • Set DMARC Configuration
      POST
    • Remove DMARC Configuration
      DELETE
    • Regenerate Domain Nameservers
      POST
  • Mailboxes
    • List mailboxes
    • Add or update signature for mailboxes
    • Delete signature for mailboxes
    • Show mailbox credentials
    • Get mailbox details
    • Buy mailboxes
    • Check mailbox status
    • Cancel mailboxes
    • Update mailbox
    • Update mailbox profile picture
    • Generate TOTP
    • Change username
    • Change password
    • Check mailbox availability
    • Get Failure Reason
  • DNS
    • Get DNS records
    • Add DNS records
    • Update DNS records
    • Delete DNS records
  • Sequencers
    • Export mailboxes status
    • List sequencer platforms
    • Get sequencer tags
    • List sequencers
    • Export mailboxes
    • Add sequencer
    • Update sequencer
    • Delete sequencers
  • Billing
    • Get pricing plans
    • Get subscription details
    • Change subscription plan
    • Cancel subscription
    • Get wallet details
    • Add credits to wallet
    • Update auto top-up settings
    • Get billing portal link
  • Warmup
    • List Warmup Subscriptions
      POST
    • Get Warmup Subscription Details
      GET
    • Add Warmup to Mailboxes
      POST
    • Pause Warmup for Mailboxes
      POST
    • Resume Warmup for Mailboxes
      POST
    • Cancel Warmup for Mailboxes
      POST
    • Get Warmup Statistics
      GET
    • Get Warmup Pricing
      GET
  • Client ID Requests
    • Initiate Client ID Request
    • Get Client ID Request Status
    • List Client ID Requests
  • Mailbox Forwarding
    • Setup Email Forwarding
    • Update Email Forwarding
    • Remove Email Forwarding
    • List Forwarding Jobs
  • Consent Request
    • Initiate Consent Request
    • Get Consent Request Status
    • List Consent Requests
  • Tags
    • Assign tags to domains or mailboxes
    • Get all tags
    • Create a new tag
    • Delete a tag
  • Prewarm
    • Search Domains
    • Search Mailboxes
    • Buy Prewarmed Mailboxes
    • Check Order Status
    • Check Availability
  • Inbox Placement
    • Tests
      • Create Test
      • List Tests
      • Get Test Results
    • Scheduled Tests
      • List Scheduled Tests
      • Get Scheduled Test
      • Pause Scheduled Test
      • Resume Scheduled Test
      • Delete Scheduled Test
  • InfraGuard
    • InfraGuard - Subscriptions
      • List protected domains
      • Get subscription details
      • Enable InfraGuard for domains
      • Cancel InfraGuard for domains
      • Get workspace statistics
      • Get pricing info
    • InfraGuard - Monitoring
      • Get blacklist check history
      • Get DNS check history
      • Get current bounce metrics
      • Get bounce check history
    • InfraGuard - Settings
      • Update subscription settings
      • Trigger manual check
    • InfraGuard - Alerts
      • List alerts
      • Acknowledge an alert
      • Resolve an alert
    • InfraGuard - Action Items
      • List action items
      • Get action item statistics
      • Resolve an action item
      • Dismiss an action item
  • Schemas
    • Schemas
      • WebhookPayload
      • DomainStatusWebhook
      • Tag
      • DomainEventData
      • MailboxStatusWebhook
      • MailboxEventData
      • Domain
      • Mailbox
      • ChangeDetails
      • WebhookResponse
      • ErrorResponse
  1. Warmup

List Warmup Subscriptions

POST
https://api.inboxkit.com/v1/api/warmup/list
Maintainer:Not configured

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
Body

🟠400Bad Request
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.inboxkit.com/v1/api/warmup/list' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "limit": 10,
    "status": "active",
    "include_cancelled": false
}'
Response 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
            },
            "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-02-17 17:06:45
Previous
Get billing portal link
Next
Get Warmup Subscription Details
Built with