Zapmail
OverviewAPI Reference
OverviewAPI Reference
  1. Deliverability Test
  • Domains
    • DNS
      • Get DNS Records
      • Add DNS Records
      • Check DNS Records
      • Add DNS Records to Multiple Domains
      • Update DNS Record
      • Delete DNS Record
    • Register
      • Search Available Domains
      • Buy Domains
      • Check Availability of Multiple Domains
      • Find Domains With AI
    • Connect
      • List Domain Connection Requests
      • Connect Domains
      • Get Nameservers to Connect a Domain
      • Verify Nameservers to Connect a Domain
      • Add Google Client ID to Domains
      • Remove Domain Connection Requests
    • Tag
      • List Domain Tags
      • Assign Tags to Domains
      • Create Domain Tags
      • Remove Tags from Domains
      • Delete Domain Tag
      • Update Domain Settings
    • Renewals
      • Search Domains Due for Renewal
      • Get Domain Renewal Prices
      • Renew Domains
      • Update Domain Auto-Renew
      • List Domains Due for Renewal
    • List Assignable Domains
      GET
    • Get Domain Health Score
      GET
    • Search Mailboxes and Domains
      GET
    • List Domains
      POST
    • Move Domains to Another Workspace
      POST
    • Remove Connected Domains
      DELETE
  • Mailbox
    • Get Authenticator Code
      GET
    • Get Mailbox
      GET
    • List Mailboxes
      POST
    • Provision Mailboxes
      POST
    • Update Mailboxes
      PUT
    • Schedule Mailbox Removal
      PUT
    • Retry Failed Mailboxes
      PUT
  • Export
    • List Third-Party Workspaces
    • Add Sequencer Details
    • Get Export Status
    • Update Sequencer Account Details
    • Add Google Client ID To Domain
    • Connect Third-Party Account
    • Connect Mailboxes With Custom OAuth
    • Fetch Workspaces by App
    • Export Mailboxes
    • Update Third-Party Account
    • Get Export Status
    • Export Mailboxes
  • Quick Setup
    • List Quick Setup Entries
    • Start Quick Setup
  • Pre-Warmed
    • List Pre-Warmed Domains
    • Count Pre-Warmed Domains
    • List Pre-Warmed Subscriptions
    • Assign Pre-Warmed Domains
    • Purchase Pre-Warmed Plan
  • Zapbox
    • List Zapbox Connected Accounts
    • List Zapbox Threads
    • Get Zapbox Thread Messages
    • Search Zapbox Emails
    • Send Zapbox Email
    • Apply Zapbox Email Action
    • Download Zapbox Attachment
    • Create Zapbox Label
    • Delete Zapbox Label
    • Rename Zapbox Label
  • User
    • Get Current User
  • Billing Details
    • Add Billing Details
    • Update Billing Details
  • Payments & Wallet
    • Get Wallet Balance
    • Add Wallet Balance
    • Enable or Disable Auto Recharge
    • Buy Add-On Mailboxes
    • Get Subscription Invoice URL
  • Subscriptions and Workspaces
    • List Workspace Members
    • List Workspace Invitations
    • List Workspaces
    • List Subscriptions
    • Create Workspace
    • Send Workspace Invitation
    • Cancel Subscription
    • List Subscription Mailboxes
    • Update Member Role
    • Update Workspace
    • Revoke Workspace Access
  • High Reputation Domains
    • List Aged Domains
    • Purchase Aged Domains
  • Deliverability
    • ZapShield
      • List ZapShield Subscriptions
      • List ZapShield Eligible Domains
      • List ZapShield Allocated Domains
      • Get ZapShield Available Slots
      • Cancel ZapShield Subscription
      • Purchase ZapShield
      • Upgrade ZapShield Plan
      • Allocate Domains to ZapShield
    • Deliverability Test
      • Get Deliverability Test Overall Report
        GET
      • List Deliverability Test Orders
        GET
      • Get Deliverability Test Report
        GET
      • List Deliverability Test Subscriptions
        GET
      • Get Deliverability Test Available Slots
        GET
      • List Deliverability Test Eligible Mailboxes
        POST
      • Purchase Deliverability Test
        POST
      • Generate Deliverability Test Spintax
        POST
      • Purchase Deliverability Test Plan
        POST
      • Cancel Deliverability Test Subscription
        POST
    • AI Insight
      • Get AI Insight Credits
      • Get AI Insight Analysis
      • Get Shared AI Insight Analysis
      • List AI Insight Eligible Mailboxes
      • Generate AI Insight Analysis
      • Calculate AI Insight Pricing
      • Purchase AI Insight Plan
      • Purchase AI Insight For Mailboxes
      • Email AI Insight Analysis
      • Share AI Insight Analysis
      • List AI Insight Analyses
      • Upgrade AI Insight Plan
    • Zap Care
      • List Zap Care Allocated Domains
      • Get Zap Care Available Slots
      • List Zap Care Subscriptions
      • List Zap Care Eligible Domains
      • Cancel Zap Care Subscription
      • Allocate Domains to Zap Care
      • Purchase Zap Care
  • Webhooks
    • List Webhook Event Types
    • List Webhook Endpoints
    • List Webhook Deliveries
    • Get Webhook Endpoint
    • Create Webhook Endpoint
    • Resend Webhook Delivery
    • Send Test Webhook Event
    • Update Webhook Endpoint
    • Delete Webhook Endpoint
  • Zap Sites
    • Get Zap Site
    • Create Zap Site
    • Regenerate Zap Site
    • Deploy Zap Site
    • Scan Zap Site Destination
    • Update Zap Site
  • Zapwarm
    • List mailboxes eligible for warmup
    • Get the Zapwarm quote for selected mailboxes
    • Start Zapwarm on selected mailboxes
    • Turn off Zapwarm on selected mailboxes
    • Edit Zapwarm settings
    • Get zapwarm score
  • ZapPulse
    • Get ZapPulse Overview
    • Get ZapPulse Insights
    • List ZapPulse Mailboxes
    • Get ZapPulse Mailbox Report
    • Create ZapPulse Report Share Link
  1. Deliverability Test

List Deliverability Test Orders

GET
https://api.zapmail.ai/api/v3/placement-tests/orders
Lists deliverability tests (one row per test, grouped by cart order) with per-test result counts. Take cartOrderId from a row to call Get Deliverability Test Report.
Paginated with page and limit (limit 1 to 100).
A test is IN_PROGRESS while any mailbox is running, FAILED when none succeeded, otherwise SUCCESS. status=SCHEDULED instead lists tests scheduled for a future run.
Count fields come from a database aggregate and are returned as numeric strings.
deliverability keeps only tests at or below that inbox percentage, which helps find problem tests.

Request

Query Params

Header Params

Responses

🟢200Success
application/json
Deliverability test groups.
Bodyapplication/json

🟠401Unauthorized
🟠403Forbidden
🟠422UnprocessableEntity
🟠429TooManyRequests
🔴500ServerError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zapmail.ai/api/v3/placement-tests/orders' \
--header 'x-auth-zapmail;'
Response Response Example
200 - One test
{
    "status": 200,
    "message": "Placement test orders fetched successfully",
    "data": {
        "testGroups": [
            {
                "cartOrderId": "b3f1c2a4-1d2e-4f5a-8b9c-0d1e2f3a4b5c",
                "testName": "October warmup check",
                "workspaceId": "3f2a1b0c-9d8e-4f6a-b1c2-d3e4f5a6b7c8",
                "createdAt": "2026-10-20T09:15:00.000Z",
                "totalMailboxes": "4",
                "spamCount": "1",
                "bounceCount": "0",
                "inboxCount": "3",
                "completed": "4",
                "inProgress": "0",
                "failed": "0",
                "deliverabilityPercentage": 75,
                "derivedStatus": "SUCCESS",
                "type": "ORDER"
            }
        ],
        "pagination": {
            "totalSearchedCount": 1,
            "currentPage": 1,
            "nextPage": null,
            "totalPages": 1
        }
    }
}
Previous
Get Deliverability Test Overall Report
Next
Get Deliverability Test Report
Built with