Get opens by mail client
/emails/metrics/clientsAuthorizationBearer-Token · headererforderlichA BillionSend API key (bs_…).
start_datestringend_datestringdomain_idstring<uuid>[]broadcast_idstring<uuid>[]Opens in the range by the mail client that fetched the message's images, most opened first (BillionSend extension). client is one of gmail, apple_mail, outlook, yahoo, thunderbird, other (a web browser, which webmail and clients without markers look like) or unknown (no user agent). Clicks are not counted by client: a click arrives from the browser the client hands the link to. Only the client is kept, never the user agent. Counts cover whole UTC hours like GET /emails/metrics, and opens are counted by client from 2026-11-16 on. A key held to one domain always reads that domain only.
objectstringerforderlichliststart_datestringerforderlichend_datestringerforderlichhas_morebooleanerforderlichdataobject[]erforderlichEigenschaften anzeigenEigenschaften ausblenden
objectclientstringerforderlichThe mail client that fetched the open
gmailapple_mailoutlookyahoothunderbirdotherunknownopenedintegererforderlichOpens by people
unique_openedintegererforderlichEmails whose first open came from here
bot_openedintegererforderlichPixel fetches by machines (scanners, prefetches)
Missing, malformed, unknown or revoked API key
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichRestricted API key: a sending_access key, or a key held to one domain that named another domain in domain_id
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichValidation error
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichThe statistics store is not answering; sending is unaffected. Retry shortly.
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich