List warmup jobs
From the Warmup API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.
GET /warmup/jobsReturns individual warmup emails (a "job" is one email sent from one warmed mailbox to another), most recent first. This endpoint doesn't take X-Project-Id. It only returns jobs where one of your own mailboxes in your active workspace (X-Workspace-Id) is the sender or the recipient; filter by account_id to scope results to a specific mailbox. An account_id that is not one of yours returns 404 not_found, and an invalid query returns 400 bad_request (invalid_query).
| Query param | Type | Description |
|---|---|---|
status | pending \| sending \| sent \| processed \| failed | Filter by job status. |
account_id | uuid | Only jobs where this account is the sender or recipient. |
limit | integer, 1-100 | Default 50. |
curl "https://app.warmerly.com/api/v1/warmup/jobs?account_id=1c2d3e4f-...&status=processed&limit=20" \
-H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"{
"jobs": [
{
"id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"senderAccountId": "1c2d3e4f-1111-4a2b-8c3d-4e5f6a7b8c9d",
"recipientAccountId": "2d3e4f5a-2222-4a2b-8c3d-4e5f6a7b8c9d",
"scheduledAt": "2026-07-02T08:00:00.000Z",
"sentAt": "2026-07-02T08:00:42.000Z",
"status": "processed",
"subject": "Re: quick question about the roadmap",
"deliveredFolder": "inbox",
"wasOpened": true,
"wasReplied": false,
"emailType": "reply"
}
]
}| Field | Type | Description |
|---|---|---|
id | uuid | Job ID. |
senderAccountId / recipientAccountId | uuid | The two mailboxes involved in the exchange. |
scheduledAt | timestamp | When the job was scheduled to send. |
sentAt | timestamp \| null | When it actually sent. |
status | string | pending, sending, sent, processed, or failed. |
subject | string | Subject line used. |
deliveredFolder | inbox \| spam \| promotions \| unknown \| null | Where the recipient mailbox filed it, once processed. |
wasOpened / wasReplied | boolean | Whether the recipient side opened or replied to it. |
emailType | string \| null | Internal template category (e.g. intro, reply). |
This endpoint returns the stored job row, so each job also carries fields such as bodyText, bodyHtml, messageId, error, errorKind, attempts and threadDepth. The example above shows only some of them.