Mailboxes

GET /api/v1/mailboxes

No parameters. The list is not paginated; next_cursor is always null.

curl https://app.seegnals.com/api/v1/mailboxes -H "Authorization: Bearer $SEEGNALS_TOKEN"

const res = await fetch("https://app.seegnals.com/api/v1/mailboxes", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.SEEGNALS_TOKEN}`
  }
});
const json = await res.json().catch(() => null);
console.log(res.status, json);

import os, requests

res = requests.get(
    "https://app.seegnals.com/api/v1/mailboxes",
    headers={"Authorization": f"Bearer {os.environ['SEEGNALS_TOKEN']}"},
    timeout=20,
)
print(res.status_code, res.json() if res.content else None)

{
  "data": [
    {
      "id": "…",
      "email": "ada@example.com",
      "provider": "smtp_imap",
      "status": "active",
      "active": true,
      "daily_limit": 50,
      "sent_today": 12,
      "timezone": "Europe/Warsaw",
      "from_name": "Ada Lovelace",
      "last_poll_error": null,
      "last_polled_at": "2026-09-04T08:55:00.000+00:00",
      "paused_from": null,
      "paused_to": null,
      "domain_health": { "domain": "example.com", "checked_at": "2026-09-04T03:00:00.000+00:00", "spf": "ok", "dkim": "unknown", "dmarc": "missing" },
      "created_at": "2026-08-01T00:00:00.000+00:00"
    }
  ],
  "next_cursor": null
}

• provider: smtp_imap, m365 or gmail.
• status: error (the inbox poller cannot read the mailbox), paused (switched off), frozen (inside the paused_from to paused_to window), active. Same precedence as the Mailboxes settings page.
• sent_today counts messages sent today in the mailbox’s own timezone.
• domain_health.spf, dkim, dmarc: ok, missing, conflicting or unknown, from the hourly check per domain. unknown means the check did not run or the resolver did not answer; it never means “no record”. checked_at: null means the domain was never checked.

Nothing here is a credential. SMTP, IMAP and OAuth secrets, the signature and any BCC settings are excluded by an explicit column list with a test on it.

Errors: 401; 429.