v1

latestOpenAPI 3.1.02026-07-2670105729.6 KB
Emails

Get inbox placement results

With testId: the current status + placement of ONE test — while status is collecting, this live-refreshes from the provider (re-poll every ~30s until completed) and returns per-provider inbox/spam/missing tallies with folder/tab categories and ACTUAL folders (e.g. Gmail Promotions, Yahoo bulk, gmx spamverdacht), each provider's OWN SPF/DKIM/DMARC verdicts (byProvider[].authentication), Microsoft's filter telemetry (microsoftFilter — SCL >= 5 lands in Junk), a spoofing check (spoofingDetected), header checks (headers — one-click unsubscribe, plain-text part), a spamFilter content verdict with the triggered rules, and a diagnosis array of per-provider findings with concrete remediation. WITHOUT testId: lists the design's recent tests (lean rows, persisted snapshots — poll a testId to refresh) for comparing subject/preview/version variants side by side. FREE.

get/v1/emails/{emailId}/inbox-placement-tests

Path parameters

emailIdstring required

Design id returned by POST /v1/emails and listed by GET /v1/emails.

Example:eml_2SmZOWV3ZQ7W5x6g3m4p

Design id returned by POST /v1/emails and listed by GET /v1/emails.

Query parameters

testIdstring

The test id returned by the create endpoint; omit to list the design's recent tests.

Example:ibp_2f1c9d8a-4e77-4b0e-9a1c-6d5e2f0b7c31

The test id returned by the create endpoint; omit to list the design's recent tests.

Response

With testId: the test resource. Without: { data: [lean test rows] }.

OR