---
title: "Current inbox_count, message_count, thread_count, and storage_bytes for this account. storage_bytes is the UTF-8 length of text plus html plus attachment size_bytes, and is not the message body. inbox_id, or an inbox-scoped key, omits domain_count and workspace_count. Otherwise those counts are for this account only. A sub-account does not see the parent. Another account's inbox is 404 inbox_not_found."
method: GET
path: "/api/v1/metrics/usage"
tags: ["Metrics"]
---

# Current inbox_count, message_count, thread_count, and storage_bytes for this account. storage_bytes is the UTF-8 length of text plus html plus attachment size_bytes, and is not the message body. inbox_id, or an inbox-scoped key, omits domain_count and workspace_count. Otherwise those counts are for this account only. A sub-account does not see the parent. Another account's inbox is 404 inbox_not_found.

`GET /api/v1/metrics/usage`

## Request

- Base URL: `https://cooperemail.com`
- URL: `https://cooperemail.com/api/v1/metrics/usage`
- Auth: HTTP bearer

## Query parameters

- `inbox_id` string: Inbox id, username, or email on this account.

## Response `200`

Usage counts

- MetricsUsage
  - `inbox_count` integer, required
  - `message_count` integer, required
  - `thread_count` integer, required
  - `storage_bytes` integer, required: UTF-8 bytes of text plus html, plus attachment size_bytes. Not the message body.
  - `domain_count` integer: Omitted when the query or key is limited to one inbox.
  - `workspace_count` integer: Omitted when the query or key is limited to one inbox.

---

[API](https://skmtc.dev/cooperemail/apis/cooper-email-api.md) · [All operations](https://skmtc.dev/cooperemail/apis/cooper-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cooperemail/apis/cooper-email-api/revisions/6d800a7b3e33?raw)