# Get warmup trends

> Returns a daily time series plus a current-vs-previous-window summary, suitable for charting score and inbox-placement rate over time. Backed by daily…

Source: https://warmerly.com/docs/warmup/get-warmup-trends

```text
GET /warmup/trends
```

Returns a daily time series plus a current-vs-previous-window summary, suitable for charting score and inbox-placement rate over time. Backed by daily `health_snapshots` rows, aggregated across the accounts you have access to.

`X-Project-Id` is optional, same as `/warmup/stats`, pass it to scope to one project. Without it the numbers cover your active workspace.

| Query param | Type | Default | Description |
| --- | --- | --- | --- |
| `days` | `7` \\| `30` \\| `90` | `30` | Length of the window. Any other value falls back to `30`. |

```bash
curl "https://app.warmerly.com/api/v1/warmup/trends?days=30" \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Project-Id: 8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a"
```

```json
{
  "range": { "days": 30, "from": "2026-06-03", "to": "2026-07-02" },
  "series": [
    { "date": "2026-06-03", "sent": 41, "inbox": 37, "spam": 3, "bounce": 1, "score": 82 },
    { "date": "2026-06-04", "sent": 45, "inbox": 42, "spam": 2, "bounce": 1, "score": 84 }
  ],
  "summary": {
    "avgScore": 87,
    "avgScorePrev": 81,
    "avgScoreDelta": 6,
    "inboxRate": 92,
    "inboxRatePrev": 88,
    "inboxRateDelta": 4,
    "sentTotal": 1240,
    "sentTotalPrev": 1105
  }
}
```

`series` is ordered ascending by `date` (UTC days) and covers the requested window only, ending today. `summary` compares the requested window against the equal-length window immediately before it (the `...Prev` fields); any rate is `null` when there's no data to divide by. `inboxRate` is `inbox / (inbox + spam + bounce)`, expressed as a whole-number percentage.

## More from Warmup

- [Get warmup stats](https://warmerly.com/docs/warmup/get-warmup-stats): Returns a point-in-time summary across your accounts: how many are active, aging, or paused, how many warmup…
- [List warmup jobs](https://warmerly.com/docs/warmup/list-warmup-jobs): Returns individual warmup emails (a "job" is one email sent from one warmed mailbox to another), most recent…
- [Per-account health and job history](https://warmerly.com/docs/warmup/per-account-health-and-job-history): Two account-scoped endpoints give you the same data filtered to a single mailbox. Both take the account ID…