Retrieve a verification
GET
/verifications/{id}Autorisation
AuthorizationJeton Bearer · headerrequisA BillionSend API key (bs_…).
Paramètres de chemin
idstring<uuid>requisRéponses
200
One verification run: its status, and its results once completed
objectstringrequisValeurs autorisées :
verificationidstring<uuid>requisstatusstringrequisqueued, submitted (being verified), completed or failed
Valeurs autorisées :
queuedsubmittedcompletedfailedfailure_reasonstring | nullrequisWhy a failed run failed; nothing is billed for it
Valeurs autorisées :
timeoutprovider_failedprovider_rejectedresults_unreadablesubmit_failednulltotalintegerrequisContacts in the run
countsobject | nullrequisResults by verdict once the run completed
billableinteger | nullrequisAddresses with a definite verdict, which is what is billed (unknown is free)
grant_usedinteger | nullrequisOf billable, covered by the free credit
meteredinteger | nullrequisOf billable, billed on the monthly invoice
created_atstringrequisfinished_atstring | nullrequis401
Missing, malformed, unknown or revoked API key
statusCodenumberrequisnamestringrequismessagestringrequis404
Not found
statusCodenumberrequisnamestringrequismessagestringrequis422
Validation error
statusCodenumberrequisnamestringrequismessagestringrequis429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequisnamestringrequismessagestringrequis