# Get account details

Returns details and status for a specific account.

## `GET /api/v1/accounts/{accountId}`

### Path parameters

- `accountId` (string, required) — Account ULID identifier

### Responses

**200** — Account details

`application/json` → Account

- `activityDay` (string | null, required) — The UTC date (YYYY-MM-DD) of the latest recorded client activity of any identity in this account, the dormancy signal; null means no recorded activity. Show it as returned, not converted to a local timezone
- `addressCreatesPerDay` (integer | null, required) — Addresses (routes) this account may CREATE per rolling day (null = platform default, 0 = unlimited)
- `billingTier` ("free" | "pro", required) — What the billing tool sold this account (system-written, PUT /accounts/:accountId/billing-tier). Not a limit: Pro's numbers are stamped only once the account is also vetted (`plan` = `trusted`); an unvetted Pro account keeps the `untrusted` numbers until an operator vets it
- `createdAt` (integer <int64>, required) — Creation timestamp in epoch seconds
- `deletedAt` (integer | null, required) — Soft-deletion timestamp in epoch seconds, or null if active
- `domainCreatesPerDay` (integer | null, required) — Domains this account may onboard per rolling day (null = platform default, 0 = unlimited)
- `forwardMsgsPerDay` (integer | null, required) — Inbound-driven egress per rolling day — mail leaving because a route was configured, with no local sender to charge (null = platform default, 0 = unlimited). Ledger is per DOMAIN, so N domains get N x this; never spends the send allowance
- `id` (string, required) — Unique account ULID
- `mailboxCreatesPerDay` (integer | null, required) — Mailboxes this account may CREATE per rolling day (null = platform default, 0 = unlimited) — a churn bound, not a ceiling; maxMailboxes is the ceiling
- `mailboxSendMsgsPerDay` (integer | null, required) — The MAILBOX DEFAULT: messages each of this account's mailboxes may send per day when it has no override of its own (null = the platform default, 0 = unlimited)
- `mailboxSendMsgsPerHour` (integer | null, required) — The MAILBOX DEFAULT's burst window: messages each mailbox may send per hour when it has no override of its own (null = the platform default, 0 = unlimited)
- `mailboxSendRcptsPerDay` (integer | null, required) — The MAILBOX DEFAULT: recipients each mailbox may send to per day when it has no override of its own (null = the platform default, 0 = unlimited)
- `mailboxSendRcptsPerHour` (integer | null, required) — The MAILBOX DEFAULT's burst window: recipients each mailbox may send to per hour when it has no override of its own (null = the platform default, 0 = unlimited)
- `maxMailboxes` (integer | null, required) — Maximum allowed mailboxes (null = the platform default, MAX_MAILBOXES_DEFAULT)
- `maxMailTemplates` (integer | null, required) — Stored mail templates this account may hold (null = the platform default, MAX_MAIL_TEMPLATES_DEFAULT; 0 = unlimited)
- `name` (string, required) — Account name
- `noticeLanguage` (string | null, required) — The language platform mail to a recipient with no identity here is written in (BCP 47, lowercased; null = English)
- `noticeMailboxId` (string | null, required) — Mailbox that receives limit notices as local postmaster mail (null = console-only)
- `plan` (string | null, required) — The service-class label last applied via POST /accounts/:accountId/plan (display/billing only — enforcement reads the limit columns; null = no plan recorded)
- `purgeAt` (integer | null, required) — Scheduled permanent purge timestamp in epoch seconds, or null
- `purgedAt` (integer | null, required) — Permanent purge completion timestamp in epoch seconds, or null
- `recoverySelfService` (boolean, required) — True if mailbox users in this account may recover their own password (recovery codes, and the recovery address once it ships). False is the admin_only policy: existing addresses and codes are KEPT and refused, and resets come from an admin. Written by the tenant via PUT /accounts/:accountId/recovery-policy
- `recvBytesPerDay` (integer | null, required) — Daily inbound byte allowance across the account (null = platform default, 0 = unlimited)
- `recvMsgsPerDay` (integer | null, required) — Daily inbound message allowance across the account (null = platform default, 0 = unlimited); a backstop — over it inbound is deferred, never bounced
- `retentionDays` (integer | null, required) — The account DEFAULT time-based retention window in days, applied to every mailbox with no window of its own (null = none, the default). Outside the plan system
- `semantic` (boolean, required) — True if this account's mailboxes may enable SEMANTIC search (the plan gate for embedding). System-written only. Clearing it is refused 409 semantic_mailboxes_opted_in while any mailbox is opted in — paid with vectors does not become free; the tenant opts out (which deletes the embeddings) or the account is deleted (which wipes them). Once none is opted in, clearing stops new opt-ins and darkens the semantic read routes (409 semantic_not_enabled)
- `sendHold` ("disabled" | "paused" | null, required) — Operator enforcement over every mailbox on every domain this account owns: 'disabled' = permanent stop, 'paused' = reversible hold, null = neither
  - _option 1: "disabled" | "paused"_
  - _option 2: null_
  - _option 3: null_
- `sendMsgsPerDay` (integer | null, required) — Daily outbound message limit (null = platform default, 0 = unlimited)
- `sendMsgsPerHour` (integer | null, required) — Hourly (burst) outbound message limit (null = platform default, 0 = unlimited)
- `sendRcptsPerDay` (integer | null, required) — Daily outbound recipient limit (null = platform default, 0 = unlimited)
- `sendRcptsPerHour` (integer | null, required) — Hourly (burst) outbound recipient limit (null = platform default, 0 = unlimited)
- `storageLimitBytes` (integer | null, required) — Account storage limit in bytes (null = platform default, 0 = unlimited)
- `vanityHosts` (boolean, required) — True if account is permitted to configure custom vanity hostnames
- `verificationToken` (string | null, required) — DNS TXT verification token for claiming domains
- `verifiedRecipientsOnly` (boolean, required) — True while the account may send only to its VERIFIED RECIPIENTS (GET /accounts/:accountId/verified-recipients): addresses on its own domains, and outside addresses whose owners confirmed them; any other outside recipient is refused 403 recipient_not_verified, that recipient alone. Stamped by the vetting label (`untrusted` on, `trusted` off; system-written, POST /accounts/:accountId/plan); false for an account never vetted either way

**401** — unauthorized: the bearer credential is missing, malformed, expired, or revoked. Carries a `WWW-Authenticate: Bearer` challenge

`application/json` → ErrorBody

**404** — Account not found or not accessible to this principal

`application/json` → ErrorBody

**503** — temporary_failure: the platform's storage could not answer just now; retry after the Retry-After window. Any operation can answer this. A write that got it may have been applied, so retry it with the same idempotency key where it takes one, or read the state back first (see Transient failures in the API description)

`application/json` → ErrorBody

### Example request

```bash
curl -X GET 'https://api.open.email/api/v1/accounts/{accountId}' \
  -H 'Authorization: Bearer oek_…'
```

## TypeScript SDK

[`openemail.accounts.get`](/docs/sdks/typescript/accounts/get)

```ts
const account = await openemail.accounts.get(accountId)
```
