Inbox Placement

Get an inbox placement run

Returns one run with its complete report: the headline split, the per-provider and per-sending-mailbox breakdowns, and the content spam rules the copy triggered. "Promotions" rolls up every Gmail category tab. "Missing" means the probe was never found in any folder, which usually indicates a silent block, and is reported apart from spam because it is a worse problem with a different fix.

get/inbox-placement/runs/{id}

Request

Base URL: https://api.emailchaser.com/r
URL: https://api.emailchaser.com/r/inbox-placement/runs/{id}
Auth: HTTP bearer

Path parameters

idinteger required

Run ID

Response

The run and its report

completedAtstring

createdAtstring

errorstring

failedinteger

idinteger

inboxinteger

inboxRateinteger

InboxRate is the whole-percentage share of SCORED probes that reached the primary inbox. -1 when nothing has been scored.

messagesExpectedinteger

messagesSentinteger

missinginteger

Missing counts probes never found in any folder, which usually means a silent block. Reported apart from spam because it is a worse problem with a different fix.

promotionsinteger

Promotions counts every Gmail category tab: promotions, social and updates. Delivered, but filtered away from the reader.

seedsTargetedinteger

sendersTargetedinteger

spaminteger

spamScoreinteger

SpamScore is the content spam score in tenths of a point, so 47 is 4.7. -1 when not scored.

startedAtstring

statusstring

Status is pending, sending, collecting, completed, failed or cancelled. Counters are only final once status is completed.

testIdinteger

triggerstring

Trigger is manual or scheduled.

Example response

{
  "id": 481,
  "inbox": 96,
  "inboxRate": 80,
  "messagesExpected": 120,
  "messagesSent": 120,
  "missing": 4,
  "promotions": 8,
  "providerBreakdown": [
    {
      "inbox": 14,
      "inboxRate": 77,
      "label": "Gmail / Google Workspace",
      "promotions": 2,
      "provider": "google",
      "seeds": 18,
      "spam": 2
    }
  ],
  "seedsTargeted": 40,
  "senderBreakdown": [
    {
      "inbox": 31,
      "inboxRate": 77,
      "missing": 1,
      "promotions": 2,
      "senderAddress": "tom@acme.com",
      "senderEmailId": 3,
      "sent": 40,
      "spam": 6
    }
  ],
  "sendersTargeted": 3,
  "spam": 12,
  "spamScore": 12,
  "spamScoreRules": [
    {
      "advice": "Write the subject in sentence case.",
      "description": "The subject line is in capitals.",
      "name": "SUBJECT_ALL_CAPS",
      "points": 15
    }
  ],
  "status": "completed",
  "testId": 12,
  "trigger": "scheduled"
}

Changes

No recorded changes to this operation across all 1 revision of this API.