List messages
Returns the delivery log for the mail the organization sent, one row per recipient with its latest outcome, newest attempt first. Pages are cursor-based: pass the nextCursor from meta to continue, and stop when hasMore is false. The date window is mandatory and defaults to the last seven days; a from earlier than the retention window is clamped to it, and meta.retentionDays reports how far back rows are kept. A row appears only once the mail server has reported an outcome, so a message accepted moments ago, or one that never reached the mail server, is absent. No subject is recorded anywhere on the send path, so none is returned. Requires the messages:read scope.
Authorizations
An organization API key, prefixed bk_live_. Takes precedence over Authorization when both are sent. The key is bound to one organization, and the scopes it was issued with are enforced per endpoint.
Headers
Required when authenticating with an access token. Optional with an API key, whose own organization binding is authoritative; a value contradicting it is refused with 403.
Query Parameters
1 <= x <= 100delivered, bounced, deferred