Retrieve a verification
GET
/verifications/{id}Autorización
AuthorizationToken Bearer · headerobligatorioA BillionSend API key (bs_…).
Parámetros de ruta
idstring<uuid>obligatorioRespuestas
200
One verification run: its status, and its results once completed
objectstringobligatorioValores permitidos:
verificationidstring<uuid>obligatoriostatusstringobligatorioqueued, submitted (being verified), completed or failed
Valores permitidos:
queuedsubmittedcompletedfailedfailure_reasonstring | nullobligatorioWhy a failed run failed; nothing is billed for it
Valores permitidos:
timeoutprovider_failedprovider_rejectedresults_unreadablesubmit_failednulltotalintegerobligatorioContacts in the run
countsobject | nullobligatorioResults by verdict once the run completed
billableinteger | nullobligatorioAddresses with a definite verdict, which is what is billed (unknown is free)
grant_usedinteger | nullobligatorioOf billable, covered by the free credit
meteredinteger | nullobligatorioOf billable, billed on the monthly invoice
created_atstringobligatoriofinished_atstring | nullobligatorio401
Missing, malformed, unknown or revoked API key
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio404
Not found
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio422
Validation error
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio