Zapmail
latest
  • latest
  • v1
  1. placement test
Zapmail
latest
  • latest
  • v1
  • Zapmail Docs
  • users
    • Retrieve User Details
      GET
  • workspaces
    • Retrieve all workspaces
      GET
    • Create new workspace
      POST
    • Update workspace
      PUT
  • billing
    • Add Billing Details
      POST
    • Update Billing Details
      PUT
  • mailbox
    • Retrieve All Mailboxes
      GET
    • Get Mailbox Details by ID
      GET
    • Assign New Mailboxes to Domains
      POST
    • Update mailbox
      PUT
    • Remove mailboxes on next renewal
      PUT
    • Get Authenticator code
      GET
    • Remove Mailboxes Instantly
      POST
    • Custom OAuth
      POST
  • payments & wallet
    • Add balance to wallet
      POST
    • Get wallet balance
      GET
    • Enable auto recharge
      POST
  • export
    • Export mailboxes
    • Add third party account details
    • Update third party account details
  • subscriptions
    • Get all subscriptions
    • Cancel subscription
    • Upgrade existing subscription
    • Purchase subscription
  • domains
    • Retrieve All Domains
    • List Assignable Domains
    • Add DMARC record
    • Add Domain forwarding
    • Get Name servers to connect domain
    • Verify Name Server Propagation
    • Connect Domain with Zapmail
    • Enable email forwarding
    • Remove email forwarding
    • Enable catch all emails
    • Remove catch all emails
    • Check DNS records
    • Remove unused domains
    • Get available domains for registration
    • Get domains purchase payment link
    • Get domain connection requests
    • Remove domain connection requests
    • Connect Domain with Zapmail (New)
    • Add Google Client ID to Domain
    • Get availability of multiple domain names.
    • Retrieve Domain Health Score
  • dns
    • Get dns records
    • Add dns records
    • Update dns records
    • Delete dns records
  • aged domains
    • Get available domains
    • Purchase aged domains
  • prewarmed domains
    • Get prewarmed domains
    • purchase prewarmed subscription
    • Assign prewarmed mailboxes
  • placement test
    • Get subscriptions
      GET
    • Get Overall Report
      GET
    • Get placement test orders
      GET
    • Get report by cart order id
      GET
    • Get Eligible Mailboxes for Placement Tests
      POST
    • Get Available Placement Test Credits
      GET
    • Purchase Placement Test
      POST
    • Purchase plan
      POST
  • dns shield
    • Get eligible domains
    • Get available slots
    • Get subscriptions
    • Get Allocated Domains for Subscription
    • Allocate Domains to DNS Shield
    • Purchase DNS Shield
    • Upgrade DNS Shield LTD Plan
    • Cancel subscription
  • Schemas
    • domain with filter
  1. placement test

Get report by cart order id

Testing
GET
/v2/placement-tests/report
Retrieve a detailed placement test report for a specific cart order. Returns comprehensive deliverability metrics, provider-specific results, and detailed analysis for all mailboxes in the cart order.

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.zapmail.ai/api/v2/placement-tests/report?cartOrderId=162c1239-xxxx' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;' \
--header 'x-service-provider;'

Responses

🟢200Success
application/json
Body

Example
{
  "status": 200,
  "message": "Placement test report retrieved successfully",
  "data": {
    "cartOrderId": "550e8400-e29b-41d4-a716-446655440000",
    "testName": "Monthly Test - December 2024",
    "status": "COMPLETED",
    "billingCycle": "MONTHLY",
    "totalMailboxes": 5,
    "completedAt": "2024-12-15T11:30:00.000Z",
    "overallMetrics": {
      "averageInboxRate": 87.5,
      "averageSpamRate": 12.5,
      "overallScore": 84.2,
      "blacklistHits": 0
    },
    "mailboxResults": [
      {
        "mailboxId": "mailbox_abc123",
        "mailboxEmail": "user1@example.com",
        "status": "COMPLETED",
        "inboxRate": 90.0,
        "spamRate": 10.0,
        "score": 88.5,
        "providerResults": [
          {
            "provider": "gmail",
            "inbox": 9,
            "spam": 1,
            "total": 10,
            "inboxRate": 90.0
          },
          {
            "provider": "microsoft365",
            "inbox": 9,
            "spam": 1,
            "total": 10,
            "inboxRate": 90.0
          }
        ],
        "spamassassinScore": 2.5,
        "blacklistCheck": {
          "isListed": false,
          "listedOn": []
        }
      },
      {
        "mailboxId": "mailbox_def456",
        "mailboxEmail": "user2@example.com",
        "status": "COMPLETED",
        "inboxRate": 85.0,
        "spamRate": 15.0,
        "score": 80.0,
        "providerResults": [
          {
            "provider": "gmail",
            "inbox": 8,
            "spam": 2,
            "total": 10,
            "inboxRate": 80.0
          },
          {
            "provider": "microsoft365",
            "inbox": 9,
            "spam": 1,
            "total": 10,
            "inboxRate": 90.0
          }
        ],
        "spamassassinScore": 3.8,
        "blacklistCheck": {
          "isListed": false,
          "listedOn": []
        }
      }
    ],
    "recommendations": [
      "Inbox rate is good but can be improved",
      "Consider checking SPF and DKIM records",
      "Monitor SpamAssassin scores above 3.0"
    ]
  }
}
Modified at 2025-12-24 13:02:52
Previous
Get placement test orders
Next
Get Eligible Mailboxes for Placement Tests
Built with