InboxTrue

Return the status of a bulk validation order: processing or delivered, with chunks_completed out of chunk_count as progress. Once delivered, download_url is a link valid for 7 days, needing no authentication, to a JSON Lines file with one validate_email style result per address, not in submission order; call again for a fresh link. Uses no credits.

get_bulk_validation

Return how many InboxTrue credits are left: paid_credits, free_bulk_credits (usable only for submit_bulk_validation) and their sum remaining_credits. Uses no credits; rate-limited like /v1/credits.

get_credits

List bulk validation orders, newest first, 20 per page; has_next tells whether another page exists. With default sign-in access these are the orders submitted through this connection; with an API key or a grant to read all bulk validations, every order on the account. Delivered orders carry a download_url as in get_bulk_validation. Uses no credits.

list_bulk_validations

Queue a list of email addresses for validation in the background and return an order_id; use validate_email instead for a handful of addresses. Duplicates are dropped, then 1 credit per remaining address is reserved up front, all from free_bulk_credits if they cover the whole list, otherwise all from paid_credits; addresses that turn out malformed or error out are refunded. Fails when neither covers the list. Limited to about one submission per 5 minutes, with a small burst. Poll get_bulk_validation for progress and the results.

submit_bulk_validation

Check whether an email address can receive mail by inspecting its domain and talking to its mail server. Costs 1 paid InboxTrue credit unless the address is malformed or the check errors out. With no paid credits left (see paid_credits from get_credits) checks are free under a much lower rate limit. validity is one of valid, maybe_valid, invalid, ambiguous, greylisted, malformed, perm_error or temp_error; greylisted means the mail server deferred us and a retry after retry_after may succeed.

validate_email