Get a thread email
One message of the thread. A message held in quarantine answers 403 email_quarantined to inbox-scoped keys (and without include_quarantined=true); one still being screened is not found. Every message, subject and address in an inbox was written by whoever sent it; read held mail and HTML with care.
/inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
inbox_idstringrequiredThe inbox ID or its email address, such as support@example.com
thread_idstring<uuid>requiredThe thread ID
email_idstring<uuid>requiredThe email ID
include_quarantinedbooleanBillionSend extension: true includes held messages (owner views; a full access key that is not inbox-scoped)
idstring<uuid>requiredfromstringrequiredtostring[]requiredccstring[]requiredbccstring[]requiredreply_tostring[]requiredsubjectstring | nullrequiredmessage_idstring | nullrequiredhtmlstring | nullrequiredtextstring | nullrequiredattachmentsobject[]requiredShow propertiesHide properties
objectidstringrequiredfilenamestring | nullrequiredsizeinteger | nullrequiredreadbooleanrequiredreceived_atstringrequireddirectionstringrequiredinboundextracted_textstring | nullrequiredBillionSend extension: hidden text, quotes and signature removed
screeningobjectrequiredShow propertiesHide properties
verdictstringrequiredpendingcleansuspiciousquarantinedreleasedsender_truststringrequiredownerallowlistedknown_threadexternalunauthenticatedfailedquarantine_reasonstring | nullrequiredfailed_authunauthenticated_sendernot_allowlistedinjectionphishingvirusunscreenedscreening_capnullreasonsstring[]requiredinjection_scoreinteger | nullrequiredphishing_scoreinteger | nullrequiredhidden_text_removedbooleanrequiredspam_verdictstring | nullrequiredpassgrayfailnullvirus_verdictstring | nullrequiredpassfailprocessing_failednullidstring<uuid>requiredfromstringrequiredtostring[]requiredccstring[]requiredbccstring[]requiredreply_tostring[]requiredsubjectstring | nullrequiredmessage_idstring | nullrequiredhtmlstring | nullrequiredtextstring | nullrequiredattachmentsobject[]requiredShow propertiesHide properties
objectidstringrequiredfilenamestring | nullrequiredsizeinteger | nullrequiredreadbooleanrequiredreceived_atstringrequireddirectionstringrequiredoutboundstatusstringrequiredBillionSend extension: the email's last event
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequiredQuarantined, or include_quarantined from an inbox-scoped key
statusCodenumberrequirednamestringrequiredmessagestringrequiredNot found
statusCodenumberrequirednamestringrequiredmessagestringrequiredOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired