Skip to main content
GET
Query Account Metrics
Returns aggregate counters for the whole account as a flat map of counter name to an array of data points. Measured live on 2026-08-24 the keys are message.received, message.received.spam, message.received.blocked, message.received.unauthenticated, message.sent, message.delivered, message.bounced, message.complained, message.rejected, message.opened and domain.verified, each an empty array on an account with no traffic — an empty array means no activity, not an error. The shape is not pinned in this spec, so read the keys actually returned rather than assuming this list is closed. This is the organization-wide view spanning every inbox in the account. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created; the inbox-scoped twin get_agentmail_inbox_metrics is the one to use when a single inbox is meant.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization
string
required

Bearer authentication

Query Parameters

event_types
enum<string>[]

List of metric event types to query.

Type of metric event.

Available options:
message.sent,
message.delivered,
message.bounced,
message.delayed,
message.rejected,
message.complained,
message.received
start
string<date-time>

Start timestamp for the query.

end
string<date-time>

End timestamp for the query.

period
string

Period in number of seconds for the query.

limit
integer

Limit on number of buckets to return.

descending
boolean

Sort in descending order.

Response

Response with status 200

Metrics grouped by event type.

{key}
MetricBucket · object[]