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 · headerrequiredA BillionSend API key (bs_…).
inbox_idstringrequiredThe 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
objectstringrequiredverification_codestatusstringrequiredfoundnoneambiguoustimeoutkindstring | nullrequiredotplinknullcodestring | nullrequiredurlstring | nullrequiredlink_domain_matches_senderboolean | nullrequiredemail_idstring<uuid> | nullrequiredfromstring | nullrequiredreceived_atstring | nullrequiredsender_truststring | nullrequiredownerallowlistedknown_threadexternalunauthenticatedfailednullMissing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequiredNot found
statusCodenumberrequirednamestringrequiredmessagestringrequiredValidation error
statusCodenumberrequirednamestringrequiredmessagestringrequiredToo many waits at once, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired