---
title: "Get account usage & limits (admin)"
method: GET
path: "/v1/accounts/usage"
tags: ["account"]
---

# Get account usage & limits (admin)

`GET /v1/accounts/usage`

## Request

- Base URL: `https://api.replylayer.ai`
- URL: `https://api.replylayer.ai/v1/accounts/usage`
- Auth: HTTP bearer

## Response `200`

Success

- object
  - `health` object
    - `bounce` object
      - `action_hint` string, nullable
      - `basis_count` number
      - `status` 'healthy' | 'watch' | 'at_risk' | 'insufficient_data'
      - `summary` string
      - `value` number
      - `window` string
    - `complaint` object
      - `action_hint` string, nullable
      - `basis_count` number
      - `status` 'healthy' | 'watch' | 'at_risk' | 'insufficient_data'
      - `summary` string
      - `value` number
      - `window` string
  - `history` object[], required
    - `count` number, required
    - `day` string, required
  - `mailbox_count` number, required
  - `mailbox_limit` number, required
  - `pending_review_count` integer, required
  - `rates` object
    - `bounce_30d` number
    - `bounce_7d` number
    - `complaint_24h` number
    - `complaint_7d` number
    - `delivery_7d` number
    - `quarantine_24h` number
  - `storage` object, required
    - `breakdown` object, required
      - `derivative_bytes` integer, required
      - `raw_mime_bytes` integer, required
    - `limit_bytes` union, required
      - integer
      - unknown
    - `percent_used` union, required
      - number
      - unknown
    - `state` 'normal' | 'warning' | 'near_full' | 'over_limit', required
    - `used_bytes` integer, required
  - `tier` string
  - `today` object, required
    - `count` number, required
    - `day` string, required
    - `limit` number, required
  - `trust` object
    - `byod_acceleration` object
      - `clean_send_progress` object
        - `bounce_rate` object, required
          - `current` number, required
          - `met` boolean, required
          - `required` number, required
        - `bounce_rate_7d` object, required
          - `current` number, required
          - `met` boolean, required
          - `required` number, required
        - `complaint_rate` object, required
          - `current` number, required
          - `met` boolean, required
          - `required` number, required
        - `payment_method` object, required
          - `met` boolean, required
        - `quarantine_rate_24h` object, required
          - `current` number, required
          - `met` boolean, required
          - `required` number, required
        - `recent_sends` object, required
          - `current` integer, required
          - `met` boolean, required
          - `required` integer, required
      - `hours_until_eligible` integer, nullable, required
      - `status` 'eligible' | 'pending_24h' | 'pending_clean_send' | 'not_eligible' | 'not_applicable', required
      - `verified_at` string, date-time, nullable, required
    - `level` number
    - `next_promotion` union
      - object
        - `eligible` boolean
        - `requirements` object
        - `target_level` number
      - unknown

## Other responses

- `401`: Missing or invalid API key
- `403`: Forbidden (code: INSUFFICIENT_SCOPE)
- `429`: Rate limited (code: RATE_LIMITED)
- `500`: Internal error (code: INTERNAL_ERROR)

---

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