Retrieve current usage and limits

Email usage against the limits that are actually enforced: the current month's counts per source category, the monthly cap applied to their total, and today's sends against the trust-tier daily ceiling.

Every figure is read from an enforcement path, so what this reports and what refuses a send cannot disagree. Correspondingly, nothing else is published — there is no billing period, invoice total or non-email meter here, because the platform meters none of those.

Two caveats worth reading before you alert on these numbers:

• The windows differ. The monthly counters roll over on the SERVER's calendar month; the daily counter buckets on the UTC date. The two therefore reset at different instants.
• monthly.limit is null once a subscription makes sending metered rather than capped, and also when an operator has set per-category limits — in that case the caps live in monthly.categories[*].limit.

Requires the usage:read scope — View your usage totals and billing limits.