Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Inbox placement

Retrieve a placement test

GET/v1/placement-tests/{id}

Retrieve a placement test with where each copy landed.

Requires a full-access key.

ZapSMTP then reads each seed mailbox (Gmail, Outlook, Yahoo and others) and records where the copy landed: inbox, a Gmail tab (promotions, social, updates, forums), spam, or missing once the test ends (15 minutes after a send). auth is the provider's own SPF, DKIM and DMARC verdict.

status is running until every seed has an answer or the test ends, then done. summary.inbox_rate = inbox (any tab) / seeds with an answer.

Path parameters

idstringrequired
The test id.

Errors

not_foundHTTP 404
placement test not found
GET/v1/placement-tests/{id}
curl 'https://api.zapsmtp.com/v1/placement-tests/019a1f2e-7c3b-7d41-9a52-0c4b8e6f1a23' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "placement_test",
  "id": "019a2b10-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
  "mode": "send",
  "token": "zp-4f9k2m8q1x7c3v5b",
  "from": "News <news@example.com>",
  "subject": "November offers",
  "status": "done",
  "created_at": "2026-11-02T10:00:00Z",
  "ends_at": "2026-11-02T10:15:00Z",
  "finished_at": "2026-11-02T10:02:30Z",
  "results": [
    {
      "provider": "gmail",
      "address": "seed1@gmail.com",
      "email_id": "019a2b10-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
      "placement": "promotions",
      "folder": "INBOX",
      "received_at": "2026-11-02T10:00:41Z",
      "auth": {
        "spf": "pass",
        "dkim": "pass",
        "dmarc": "pass"
      }
    },
    {
      "provider": "outlook",
      "address": "seed1@outlook.com",
      "email_id": "019a2b10-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
      "placement": "inbox",
      "folder": "INBOX",
      "received_at": "2026-11-02T10:00:41Z",
      "auth": {
        "spf": "pass",
        "dkim": "pass",
        "dmarc": "pass"
      }
    },
    {
      "provider": "yahoo",
      "address": "seed1@yahoo.com",
      "email_id": "019a2b10-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
      "placement": "spam",
      "folder": "Bulk",
      "received_at": "2026-11-02T10:00:41Z",
      "auth": {
        "spf": "pass",
        "dkim": "pass",
        "dmarc": "pass"
      }
    }
  ],
  "summary": {
    "total": 3,
    "inbox": 2,
    "primary": 1,
    "promotions": 1,
    "social": 0,
    "updates": 0,
    "forums": 0,
    "spam": 1,
    "missing": 0,
    "pending": 0,
    "inbox_rate": 0.666
  }
}