---
title: "Read effective account limits"
method: GET
path: "/v1/account/limits"
tags: ["Accounts"]
---

# Read effective account limits

`GET /v1/account/limits`

## Request

- Base URL: `https://api.revdoku.com`
- URL: `https://api.revdoku.com/v1/account/limits`
- Auth: HTTP bearer

Values come from the plan and account overrides. Zero means no allowance; null means no cap. Storage, mailbox and email traffic allowances are shared within a billing group.

## Query parameters

- `account_id` string

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required
    - `account_id` string, required
    - `limits` AccountLimits, required
      - `max_mailboxes` integer, nullable, required
      - `max_mailbox_creations_per_month` integer, nullable, required
      - `max_files_per_mailbox` integer, nullable, required
      - `max_current_files` integer, nullable, required
      - `max_storage_bytes` integer, nullable, required
      - `max_file_size_bytes` integer, nullable, required
      - `max_pdf_size_bytes` integer, nullable, required
      - `max_file_versions_per_file` integer, nullable, required
      - `max_email_domains` integer, nullable, required
      - `max_received_emails_per_month` integer, nullable, required
      - `max_received_email_bytes_per_month` integer, nullable, required
      - `max_received_email_message_bytes` integer, nullable, required
      - `max_sent_emails_per_month` integer, nullable, required: Sent-email recipients per billing period, shared by the billing group. Each recipient counts once.
      - `max_email_address_rotations_per_month` integer, nullable, required
      - `max_account_members` integer, nullable, required
      - `max_api_keys` integer, nullable, required
      - `max_agent_connections` integer, nullable, required
      - `api_rate_limit_requests_per_minute` integer, nullable, required
      - `audit_retention_days` integer, nullable, required
      - `max_email_aliases_per_mailbox` integer, required: Active retained email addresses (aliases) per mailbox. Zero means that the plan has no aliases.
    - `usage` object
      - `mailbox_creations` object
        - `monthly_limit` integer, nullable
        - `used` integer
        - `remaining` integer, nullable
        - `resets_at` string, date-time

## Other responses

- `default`: Request failed. See error.code. Any 429 or 503 response with Retry-After (for example 503 EMAIL_LABELING_PENDING or 503 EMAIL_INDEX_BUILDING): wait that many seconds, then try the read again. 429 EMAIL_SEND_RATE_LIMITED has no Retry-After. Never retry EMAIL_LOOP_DETECTED.

---

[API](https://skmtc.dev/revdoku/apis/revdoku-api.md) · [All operations](https://skmtc.dev/revdoku/apis/revdoku-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revdoku/apis/revdoku-api/revisions/3ff4e2540a8b?raw)