---
title: "Inbox placement stats by date"
method: GET
path: "/inbox-placement/stats-by-date"
tags: ["Inbox Placement"]
---

# Inbox placement stats by date

`GET /inbox-placement/stats-by-date`

## Request

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

Rolls completed runs up by UTC calendar day over a window, for a trend chart. Days on which nothing ran are ABSENT from the series rather than returned as zeros: a zero-filled day plots as placement collapsing to 0%, which reads as an outage when it means nobody ran a test. Defaults to the last 30 days.

## Query parameters

- `from` string
- `to` string

## Response `200`

The daily series

- ModelsInboxPlacementStatsByDateResponse
  - `days` ModelsInboxPlacementDailyStatResponse[]
    - `date` string: Date is the UTC day.
    - `inbox` integer
    - `inboxRate` integer
    - `missing` integer
    - `promotions` integer
    - `runs` integer
    - `spam` integer
  - `from` string
  - `to` string

## Other responses

- `400`: Malformed or reversed date range
- `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 history

---

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