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


---

Previous: [Signup](https://robotomail.com/docs/api/signup.md) | Next: [API Keys](https://robotomail.com/docs/api/api-keys.md)