Get latest code
BillionSend extension: the newest code or sign-in link in delivered mail, never from held mail or senders that failed authentication; links are never fetched. max_age counts from delivery, so a code released from quarantine counts from its release; since skips mail received at or before it, so a second sign-in waits for its own code. wait > 0 long-polls until one arrives (status timeout when none did). Always 200; status none when there is nothing.
/inboxes/{inbox_id}/codes/latestAuthorizationBearer-Token · headererforderlichA BillionSend API key (bs_…).
inbox_idstringerforderlichThe inbox ID or its email address, such as support@example.com
fromstringAn exact sender address, or a domain covering itself and its subdomains
waitintegerSeconds to wait for a code to arrive, 0-50 (default 0)
max_ageintegerHow long ago the code may have reached the inbox, in seconds, 60-86400 (default 600); a released code counts from its release
sincestring<date-time>Only mail received after this ISO 8601 instant, such as the received_at of a code already used
The latest code, or a status saying why none
objectstringerforderlichverification_codestatusstringerforderlichfoundnoneambiguoustimeoutkindstring | nullerforderlichotplinknullcodestring | nullerforderlichurlstring | nullerforderlichlink_domain_matches_senderboolean | nullerforderlichemail_idstring<uuid> | nullerforderlichfromstring | nullerforderlichreceived_atstring | nullerforderlichsender_truststring | nullerforderlichownerallowlistedknown_threadexternalunauthenticatedfailednullMissing, malformed, unknown or revoked API key
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichNot found
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichValidation error
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlichToo many waits at once, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich