---
title: "Sender reputation and health"
method: GET
path: "/inbox-placement/sender-reputation"
tags: ["Inbox Placement"]
---

# Sender reputation and health

`GET /inbox-placement/sender-reputation`

## Request

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

The latest health check for every connected mailbox: SPF, DKIM, DMARC and MX status, blacklist listings with their delisting links, measured inbox placement, and a combined 0-100 health score. blacklistsChecked is reported next to blacklistsListed so the count can never be read as a total. A placementScore or healthScore of -1 means not measured, not zero.

## Response `200`

The mailbox health table

- ModelsSenderReputationListResponse
  - `count` integer
  - `items` ModelsSenderReputationResponse[]
    - `blacklistListings` ModelsBlacklistListingResponse[]
      - `answer` string
      - `delistUrl` string: DelistURL is where to request removal. Always present: a listing you cannot act on is trivia.
      - `kind` string
      - `name` string
      - `reason` string
      - `txt` string
      - `value` string
      - `zone` string
    - `blacklistsChecked` integer: BlacklistsChecked is how many zones were queried, reported next to the listing count so the number can never be read as a total.
    - `blacklistsListed` integer
    - `checkedAt` string
    - `dkimStatus` string
    - `dmarcPolicy` string
    - `dmarcStatus` string
    - `dnsIssues` string[]
    - `domain` string
    - `healthScore` integer: HealthScore is 0-100 combining placement, authentication and blacklist standing. -1 when it cannot be computed.
    - `mxStatus` string
    - `placementScore` integer: PlacementScore is the inbox rate over recent completed runs. -1 when the mailbox has never been tested.
    - `senderAddress` string
    - `senderEmailId` integer
    - `sendingIp` string: SendingIP is empty for mailboxes on a shared provider (Gmail, Microsoft), which have no dedicated IP of their own to check.
    - `spfStatus` string: Each status is OK, WARNING, MISSING or ERROR.

## 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 load the mailbox health

---

[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)