Get opens by mail client
/emails/metrics/clientsAuthorizationJeton Bearer · headerrequisA 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.
objectstringrequisliststart_datestringrequisend_datestringrequishas_morebooleanrequisdataobject[]requisAfficher les propriétésMasquer les propriétés
objectclientstringrequisThe mail client that fetched the open
gmailapple_mailoutlookyahoothunderbirdotherunknownopenedintegerrequisOpens by people
unique_openedintegerrequisEmails whose first open came from here
bot_openedintegerrequisPixel fetches by machines (scanners, prefetches)
Missing, malformed, unknown or revoked API key
statusCodenumberrequisnamestringrequismessagestringrequisRestricted API key: a sending_access key, or a key held to one domain that named another domain in domain_id
statusCodenumberrequisnamestringrequismessagestringrequisValidation error
statusCodenumberrequisnamestringrequismessagestringrequisOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequisnamestringrequismessagestringrequisThe statistics store is not answering; sending is unaffected. Retry shortly.
statusCodenumberrequisnamestringrequismessagestringrequis