---
title: "Get org-wide usage summary"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get org-wide usage summary

`GET /usage`

Returns aggregated email sending statistics for your entire organization.
For per-tenant breakdown, use `GET /usage/tenants`.

**Use cases:**
- Platform dashboards showing org-wide metrics
- Quick health check on overall sending
- Monitoring total volume and delivery rates

**Response includes:**
- `emails` - Aggregated email counts across all tenants
- `rates` - Overall delivery and bounce rates
- `tenants` - Tenant count summary (total, active, with activity)

**Related endpoints:**
- `GET /usage/tenants` - Paginated usage per tenant
- `GET /usage/export` - Export usage data for billing
- `GET /tenants/{tenantId}/usage` - Single tenant usage details
- `GET /limits` - Rate limits and send limits

## Query parameters

- `period` string
- `timezone` string

## Response `200`

Org-wide usage summary

- OrgUsageSummaryResponse — Org-wide usage summary response
  - `success` true, required
  - `data` object, required
    - `period` UsagePeriod, required — Time period for usage data
      - `start` string, date-time, required — Period start (inclusive)
      - `end` string, date-time, required — Period end (inclusive)
    - `emails` EmailCounts, required — Email delivery counts
      - `sent` integer, required — Total emails sent
      - `delivered` integer, required — Emails successfully delivered
      - `soft_failed` integer, required — Emails that soft-failed (temporary failures, may be retried)
      - `hard_failed` integer, required — Emails that hard-failed (permanent failures)
      - `bounced` integer, required — Emails that bounced
      - `held` integer, required — Emails currently held for review
    - `rates` EmailRates, required — Email delivery rates (as decimals, e.g., 0.95 = 95%)
      - `delivery_rate` number, float, required — Percentage of sent emails that were delivered (0-1)
      - `bounce_rate` number, float, required — Percentage of sent emails that bounced (0-1)
    - `tenants` object, required
      - `total` integer, required — Total number of tenants
      - `active` integer, required — Number of active tenants
      - `withActivity` integer, required — Number of tenants with sending activity
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded
- `500` — Internal server error
- `503` — Usage statistics temporarily unavailable

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/versions/98a90852ffca/schema)