Retrieve a verification
GET
/verifications/{id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstring<uuid>requiredResponses
200
One verification run: its status, and its results once completed
objectstringrequiredAllowed:
verificationidstring<uuid>requiredstatusstringrequiredqueued, submitted (being verified), completed or failed
Allowed:
queuedsubmittedcompletedfailedfailure_reasonstring | nullrequiredWhy a failed run failed; nothing is billed for it
Allowed:
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 | nullrequired401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired