List inboxes
The team’s inboxes, newest first (after pages toward older ones). An inbox-scoped key lists only its inbox.
GET
/inboxesAuthorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Query parameters
limitintegerPage size, 1-100 (default 20)
min 1 · max 100
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.
kindstringBillionSend extension: agent or human inboxes only
Allowed:
agenthumanResponses
200
Inboxes
objectstringrequiredAllowed:
listhas_morebooleanrequireddataobject[]requiredShow propertiesHide properties
Array of
objectidstring<uuid>requirednamestring | nullrequiredemail_addressstringrequiredfrom_namestring | nullrequiredunreadintegerrequiredlast_receivedstring | nullrequiredcreated_atstringrequiredupdated_atstringrequiredkindstringrequiredAllowed:
agenthumansharedbooleanrequiredexpires_atstring | nullrequired401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Pagination cursor not found
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired