MailPilot API

List mailboxes

Returns every connected mailbox with live reputation, placement, and warmup metrics computed from the last 14 days of send history. Paginated once an account has more than `limit` mailboxes - below that the response is a bare array for convenience.

GET
/api/email-accounts

Returns every connected mailbox with live reputation, placement, and warmup metrics computed from the last 14 days of send history. Paginated once an account has more than limit mailboxes - below that the response is a bare array for convenience.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

An API key generated from Settings → API Keys in the MailPilot dashboard, sent as Authorization Bearer <key>.

In: header

Query Parameters

page?integer

1-indexed page number. Only relevant once you have more mailboxes than limit.

Range1 <= value
Default1
limit?integer

Page size, capped at 200.

Range1 <= value <= 200
Default200

Response Body

application/json

application/json

curl -X GET "https://example.com/api/email-accounts"
{  "data": [    {      "id": 101,      "email": "outreach@example.com",      "displayName": null,      "espType": "SMTP_IMAP",      "status": "ACTIVE",      "dailySendLimit": 40,      "dailySentCount": 12,      "dailyReceivedCount": 9,      "dailyRepliesReceivedCount": 2,      "reputationScore": 87,      "placementRate": 94.5,      "espGoogleWeight": 50,      "espMicrosoftWeight": 30,      "espOtherWeight": 20,      "lastWarmupStartedAt": "2026-07-01T08:00:00.000Z",      "createdAt": "2026-06-20T10:15:00.000Z",      "updatedAt": "2026-08-01T09:00:00.000Z",      "sentToday": 12,      "sentWeek": 84,      "receivedToday": 9,      "receivedWeek": 61,      "warmupScore": 82,      "warmupStatus": "ready",      "warmupSettings": {        "status": "RUNNING",        "currentDay": 24,        "dailySendingLimit": 40,        "useOwnTemplates": true,        "hiddenWarmup": false      }    }  ]}