Account

Retrieve your account details, usage stats, and plan information.

GET /v1/account

GET/v1/account

Requires authentication with a full-access API key. Scoped (mailbox-restricted) keys receive 403.

response — 200 OK

{
  "account": {
    "id": "clx1a2b3c0000abcd1234efgh",
    "email": "you@example.com",
    "emailVerified": true,
    "slug": "myagent",
    "plan": "free",
    "suspended": false,
    "suspendedReason": null,
    "storageUsedBytes": 524288,
    "storageLimitBytes": 1073741824,
    "mailboxCount": 1,
    "activeMailboxCount": 1,
    "sentToday": 12,
    "sentThisMonth": 240,
    "receivedToday": 5,
    "bouncedToday": 0,
    "monthlyInboundCount": 42,
    "monthlyInboundLimit": 100,
    "monthlyInboundPercentage": 42,
    "monthlyInboundResetAt": "2026-05-01T00:00:00.000Z",
    "overLimitMessageCount": 0
  }
}

DELETE /v1/account

DELETE/v1/account

Permanently delete your account and all associated data. Requires full-access authentication (unscoped API key or dashboard session). You must include a confirmation body to prevent accidental deletion.

curl

curl -X DELETE https://api.robotomail.com/v1/account \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirm": "DELETE"}'

response — 200 OK

{ "deleted": true }

This permanently deletes all account data from the database (mailboxes, messages, attachments, domains, webhooks, API keys). External service cleanup (R2 storage, Resend domains, Stalwart accounts, Stripe subscription) is performed best-effort after the database deletion.

Errors

400 — Missing or invalid confirmation body
401 — Not authenticated
403 — Scoped API key (requires unscoped key or session)