Skip to documentation

Dashboard

Usage

See your team's email volume and audience size, and the shared Amazon SES quota.

The Usage page

Open Settings → Usage. A self-hosted installation has no billing plan, so the page only reports what your team has used. Email totals use UTC calendar days and months.

CardShowsLimitResets
Emails todayEmails sent plus emails received todayThe Amazon SES daily quota of the installation's default region, or Unavailable when none is recordedMidnight UTC
Emails this monthEmails sent plus emails received this monthUnlimitedThe first of the next month, 00:00 UTC
ContactsContacts stored by the teamUnlimited
SegmentsSegments the team has createdUnlimited
Broadcasts sentBroadcasts the team has sentUnlimited

Each card reads used / limit. Emails today has a progress bar when a quota is available.

The shared SES quota

The daily limit is the Max24HourSend quota Amazon SES reports for the installation's default region, and every team on the installation shares it. SES enforces it over a rolling 24 hours, while this page counts UTC calendar days, and its totals include received mail. So the page shows how much your team used, not how much SES capacity is left.

The quota is read when the AWS connection is checked and when a region or domain is set up. The Shared Amazon SES quota note on the page says when it was last checked. If no quota has been recorded, or no default region is set up, the note says so. The installation administrator can refresh it from Amazon SES settings; for them, the note links there with an Amazon SES settings button.

To raise the quota, request a limit increase or production access for the region in the AWS console.

Use the API

GET /usage with a full-access key returns the same numbers, plus a few more:

json
{
  "object": "usage",
  "emails": {
    "daily": { "used": 120, "limit": 50000, "sent": 100, "received": 20, "resets_at": "2026-09-30T00:00:00.000Z" },
    "monthly": { "used": 2400, "limit": null, "sent": 2000, "received": 400, "resets_at": "2026-10-01T00:00:00.000Z" }
  },
  "contacts": { "used": 850, "limit": null },
  "segments": { "used": 12, "limit": null },
  "broadcasts": { "used": 4, "limit": null },
  "ai_credits": { "used": 0, "limit": 0, "next_increase_at": null },
  "automation_runs": { "used": 37, "limit": null, "resets_at": "2026-10-01T00:00:00.000Z" },
  "domains": { "used": 2, "limit": null },
  "rate_limit": { "limit": 10, "duration": "1000ms" }
}

A limit of null means unlimited, except for emails.daily, where null means no SES quota has been recorded. automation_runs counts runs started this UTC month. ai_credits is always zero. rate_limit is the API limit of 10 requests a second, shared by all of the team's keys.