---
title: "Deliverability insights"
method: GET
path: "/inbox-placement/insights"
tags: ["Inbox Placement"]
---

# Deliverability insights

`GET /inbox-placement/insights`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/inbox-placement/insights`
- Auth: HTTP bearer

What is wrong across the workspace right now, worst first, each with the action that fixes it. Combines the placement measured over the window with the latest health check of every connected mailbox: authentication records, blacklist listings and measured placement per mailbox.

## Query parameters

- `days` integer

## Response `200`

The findings

- ModelsInboxPlacementInsightsResponse
  - `findings` ModelsInboxPlacementFindingResponse[]
    - `action` string: Action is what to do about it. Every finding has one: a report that only says what is wrong makes the reader's day worse without improving their delivery.
    - `detail` string
    - `senderAddress` string
    - `senderEmailId` integer
    - `severity` string: Severity is critical, warning or info.
    - `title` string
  - `inboxRate` integer
  - `mailboxesAtRisk` integer
  - `mailboxesChecked` integer
  - `missingRate` integer
  - `providerBreakdown` ModelsInboxPlacementProviderResponse[]
    - `inbox` integer
    - `inboxRate` integer
    - `label` string
    - `missing` integer
    - `promotions` integer
    - `provider` string
    - `seeds` integer
    - `spam` integer
  - `runsInWindow` integer
  - `spamRate` integer
  - `windowDays` integer: WindowDays is how far back the rates below were computed over.

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `403`: The workspace does not hold the Inbox Placement add-on (code inbox_placement_required)
- `500`: Failed to build the insights

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)