List drafts
Unsent drafts (draft and pending_approval), most recently updated first; after pages toward older ones.
/inboxes/{inbox_id}/draftsAuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
inbox_idstringrequiredThe inbox ID or its email address, such as support@example.com
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.
Drafts
objectstringrequiredlisthas_morebooleanrequireddataobject[]requiredShow propertiesHide properties
objectidstring<uuid>requiredtypestringrequiredstandalonereplytostring[] | nullrequiredccstring[]requiredbccstring[]requiredsubjectstring | nullrequiredsnippetstring | nullrequiredthread_idstring<uuid> | nullrequiredreply_to_email_idstring<uuid> | nullrequiredupdated_atstringrequiredattachmentsobject[]requiredShow propertiesHide properties
objectidstringrequiredfilenamestringrequiredcontent_typestringrequiredsizeintegerrequiredstatusstringrequireddraftpending_approvalsentrejectedexpiredapproval_reasonsstring[]requiredsend_atstring | nullrequiredBillionSend extension: when the scheduled send goes out; null when not scheduled
send_errorstring | nullrequiredBillionSend extension: the error name of the last scheduled send that was refused (e.g. invalid_api_key, inbox_send_cap_reached, not_found); null otherwise
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequiredRestricted API key, the inbox's or the shared domain's rules, or held mail
statusCodenumberrequirednamestringrequiredmessagestringrequiredNot found
statusCodenumberrequirednamestringrequiredmessagestringrequiredIdempotency conflict, or a draft already sent
statusCodenumberrequirednamestringrequiredmessagestringrequiredValidation error
statusCodenumberrequirednamestringrequiredmessagestringrequiredThe inbox's daily send limit, or the team's daily limit for mail from the shared domain, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired