---
title: "Get a sender email's warm-up settings"
method: GET
path: "/sender-emails/{id}/warmup"
tags: ["Sender Emails"]
---

# Get a sender email's warm-up settings

`GET /sender-emails/{id}/warmup`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/sender-emails/{id}/warmup`
- Auth: HTTP bearer

Returns the mailbox's warm-up configuration: whether warm-up is on, the ramp (startLimit warm-up emails on the first day, increaseBy more each day, up to capLimit a day), weekdays-only, timezone, today's ramp target (currentPerDay) and the account's health score (healthScore, 0-100, higher is better: the share of its warm-up emails over the last 7 full days that landed in the inbox rather than spam; null while warm-up is off or before 20 were checked). Warm-up volume is separate from the campaign sending limits on the sender email. When configured is false the mailbox has never been enrolled, and the values shown are the defaults that switching warm-up on would use.

## Path parameters

- `id` integer, required

## Response `200`

Warm-up settings

- ModelsSenderEmailWarmupSettingsResponse
  - `activatedAt` string: ActivatedAt is when warm-up was first switched on; the ramp counts days from here. Null until then.
  - `capLimit` integer: CapLimit is the most warm-up emails a day; the ramp stops here.
  - `configured` boolean: Configured is true once the mailbox has warm-up settings of its own. While false the mailbox has never been enrolled, and the values below are the defaults that switching warm-up on would use.
  - `currentPerDay` integer: CurrentPerDay is today's ramp target, 0 while warm-up is off. On a weekend a weekdays-only mailbox still shows its ramp value, although no warm-up emails send that day.
  - `enableReplies` boolean: EnableReplies lets warm-up recipients reply, adding reply signals.
  - `enabled` boolean: Enabled is true while the mailbox is warming.
  - `healthScore` integer: Health score 0-100, higher is better: the share of this account's warm-up emails over the last 7 full days that landed in the inbox rather than spam; 90+ is the app's bar for campaigns. It moves daily as warm-up emails land in the inbox (up) or in spam (down). Null while warm-up is off or before 20 warm-up emails were checked.
  - `increaseBy` integer: IncreaseBy is how many warm-up emails are added each day until CapLimit.
  - `senderEmailId` integer
  - `startLimit` integer: StartLimit is how many warm-up emails go out on the first day.
  - `timezone` string: Timezone is the IANA timezone the warm-up send window runs in.
  - `weekdaysOnly` boolean: WeekdaysOnly limits warm-up sending to Monday through Friday.

## Other responses

- `400`: Invalid sender email ID
- `401`: Unauthorized - invalid or missing API key
- `404`: Sender email not found
- `500`: Failed to get warm-up settings

---

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