List verifications
Newest first, with cursor pagination: after takes the last id of a page and pages toward older items, before takes the first id and pages back toward newer ones.
/verificationsAuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
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.
The team's verification runs, newest first
objectstringrequiredlistdataobject[]requiredShow propertiesHide properties
objectobjectstringrequiredverificationidstring<uuid>requiredstatusstringrequiredqueued, submitted (being verified), completed or failed
queuedsubmittedcompletedfailedfailure_reasonstring | nullrequiredWhy a failed run failed; nothing is billed for it
timeoutprovider_failedprovider_rejectedresults_unreadablesubmit_failednulltotalintegerrequiredContacts in the run
countsobject | nullrequiredResults by verdict once the run completed
billableinteger | nullrequiredAddresses with a definite verdict, which is what is billed (unknown is free)
grant_usedinteger | nullrequiredOf billable, covered by the free credit
meteredinteger | nullrequiredOf billable, billed on the monthly invoice
created_atstringrequiredfinished_atstring | nullrequiredhas_morebooleanrequiredMissing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequiredValidation error
statusCodenumberrequirednamestringrequiredmessagestringrequiredOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired