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

List placement tests

GET/v1/placement-tests

List placement tests, newest first, with cursor pagination.

Requires a full-access key.

Pass next_cursor as after for the next page.

Query parameters

limitinteger
1-100. Limits: 422 invalid_parameter otherwise. Default 20.
afterstring
A test id from next_cursor. Limits: 422 invalid_parameter otherwise.

Errors

invalid_parameterHTTP 422
GET/v1/placement-tests
curl 'https://api.zapsmtp.com/v1/placement-tests?limit=20' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "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
      }
    }
  ]
}