List a thread's emails
Received and sent messages of the thread, oldest first (after pages toward newer ones), with their bodies. Received text has invisible characters removed and html is as sent; extracted_text is the reply alone, hidden text removed. Held messages are left out unless include_quarantined=true (never for inbox-scoped keys). 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}/emailsAuthorizationBearer 令牌 · header必填A BillionSend API key (bs_…).
inbox_idstring必填The inbox ID or its email address, such as support@example.com
thread_idstring<uuid>必填The thread ID
limitintegerPage size, 1-100 (default 20)
afterstring<uuid>Cursor: id of the last item of the current page; returns the next page. Must be an id this list returned; there is no sentinel value.
beforestring<uuid>Cursor: id of the first item of the current page; returns the previous page; same rule as after.
include_quarantinedbooleanBillionSend extension: true includes held messages (owner views; a full access key that is not inbox-scoped)
Emails
objectstring必填listhas_moreboolean必填dataInboxThreadEmail[]必填显示属性隐藏属性
InboxThreadEmail 数组idstring<uuid>必填fromstring必填tostring[]必填ccstring[]必填bccstring[]必填reply_tostring[]必填subjectstring | null必填message_idstring | null必填htmlstring | null必填textstring | null必填attachmentsobject[]必填显示属性隐藏属性
object 数组idstring必填filenamestring | null必填sizeinteger | null必填readboolean必填received_atstring必填directionstring必填inboundextracted_textstring | null必填BillionSend extension: hidden text, quotes and signature removed
screeningobject必填显示属性隐藏属性
verdictstring必填pendingcleansuspiciousquarantinedreleasedsender_truststring必填ownerallowlistedknown_threadexternalunauthenticatedfailedquarantine_reasonstring | null必填failed_authunauthenticated_sendernot_allowlistedinjectionphishingvirusunscreenedscreening_capnullreasonsstring[]必填injection_scoreinteger | null必填phishing_scoreinteger | null必填hidden_text_removedboolean必填spam_verdictstring | null必填passgrayfailnullvirus_verdictstring | null必填passfailprocessing_failednullidstring<uuid>必填fromstring必填tostring[]必填ccstring[]必填bccstring[]必填reply_tostring[]必填subjectstring | null必填message_idstring | null必填htmlstring | null必填textstring | null必填attachmentsobject[]必填显示属性隐藏属性
object 数组idstring必填filenamestring | null必填sizeinteger | null必填readboolean必填received_atstring必填directionstring必填outboundstatusstring必填BillionSend extension: the email's last event
Missing, malformed, unknown or revoked API key
statusCodenumber必填namestring必填messagestring必填include_quarantined from an inbox-scoped key
statusCodenumber必填namestring必填messagestring必填Inbox, thread or cursor not found
statusCodenumber必填namestring必填messagestring必填Validation error
statusCodenumber必填namestring必填messagestring必填Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumber必填namestring必填messagestring必填