Get warmup trends

API referenceWarmup

From the Warmup API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.

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.

Was this page helpful?

Get warmup trends

More from Warmup